A showcase of Gemeente Amsterdam's Open Source work, a comprehensive guide on how to contribute to our projects and our vision how we believe Open Source software should be built in Amsterdam.
Feel free to make pull requests, we'll review and merge them as soon as we can. Feel free to edit the MarkDown files, if you are unfamilliar with this, the Mastering MarkDown guide is pretty good
Be sure to read the CONTRIBUTING.md for more information on contributing.
We believe that sharing our knowledge will help the development of great Open Source software for Amsterdam and the world.
Our guides are for everyone, whatever their affiliation. They should be general, understandable for ‘beginners’ and not contain too much technical detail. The content of this website should be broadly applicable to every one of our projects, and thus not feature 'style guides' etc, those are better at home with projects in their repositories.
To add a guide just make a new markdown file in /guides/. In order to give your guide the right subtitle on the guides page you should add the explains in the Jekyll front matter. Keep the explains short and simple to understand.
---
explains: How to add guides, add pages and change this website
---To add a project just make a new markdown file in /projects/. Add an abstract in the front matter as a short description of what the product is.
You can either make a new Project page on this site or link directly to an external repo or product page by adding a link property to the front matter.
---
title: Catalog
abstract: A drop in replacement for CKAN
link: https://github.com/Amsterdam/datacatalog-core
---This site and it's contents are served over GitHub pages and redered in it's native static site genrator Jekyll.
More on Jekyll as a static site generator with GitHub.
Install Ruby and it's package manager Bundler with
gem install bundlerInstall the dependencies and Jekyll using
bundle installRun Jekyll, generate the site, watch for changes and serve over a local webserver with
jekyll serve --livereload