This document describes the software, services, and expertise that will be needed for the implementation of the Open SDG platform.
All the software described here is open source and free to use.
The platform is powered mostly by Jekyll. In fact, this repository is a Jekyll theme. By compiling the platform to a static website, Jekyll allows for the easiest possible deployment.
Maintenance and development of the platform requires the use of Git. Most maintenance tasks can be performed without using command-line Git (thanks to Github.com and Prose.io - see below) but for development, Git will be an important tool.
Most implementations of the platform will not require alterations to any of the Python scripts involved in the "build process," but developers should be aware that additional build-time manipulations of data/metadata may require some knowledge of Python. Any extra validation may also require Python code.
All the services described here can be used without paying fees.
Github.com provides 2 key functions:
- Git repository: As a Git "remote," Github.com will be the central location for all maintenance and development, both for the platform and its content, data, and metadata.
- Platform hosting: Through the free "Github Pages" offering, Github.com will provide free hosting of the platform.
Prose.io provides a data management interface, which allows non-technical data providers to update data and metadata, using only their web browser.
CircleCI (or similar)¶
CircleCI allows the platform to be automatically "built" in response to simple workflows. The key ones are:
- When code is pushed to the "develop" Git branch, build and deploy to staging.
- When code is pushed to the "master" Git branch, build and deploy to production.
- When a Github pull request is created, run tests against the new code.
The notes below apply to developers tasked with implementing this platform, adding/changing functionality, and/or updating the look-and-feel.
For development, basic familiarity with Git (command-line) will be important.
Since the platform is a Jekyll site, familiarity with the configuration and structure of the Jekyll framework will be important. Additionally, as with any Jekyll site, some familiarity with the Liquid template language is necessary.
Some experience with continuous integration (CI) — such as with integrating Github sites with TravisCI or CircleCI — will be helpful. Developers will NOT need to implement this integration from scratch, but any customisation of the automation workflows will require some basic familiarity with open-source CI practices.