Archives
-
Orchard Harvest Conference 2017
Please join us for our next Orchard Harvest Conference 2017.
February 21 - 22, 2017 (Tuesday - Wednesday)
The event will be held in New York, USA at the TKP New York Conference Center.
2 Days of Community, Networking, Speakers, and Social Activities
We are very excited about this event and look forward to welcoming members of the Orchard Project open source community from across North America as well as from around the globe.
For more information about the event, please visit the Orchard Harvest Conference 2017 website.
-
Orchard documentation migration
The documentation of the Orchard project is a community effort and an open source initiative.
The Orchard team decided from the very beginning to use Markdown files to manage the documentation pages and to publish the source code on GitHub so that people can contribute providing pull requests.
Recently, the documentation has been migrated to MkDocs in order to be hosted easily on ReadTheDocs.
The benefits are almost the same than previously :
- Any changes on the repository will automatically be deployed after a commit/push thanks to a WebHook.
- You just have to know the Markdown syntax to edit the files.
Some new features convinced us to switch to ReadTheDocs :
- The files are statically generated, so the display is pretty fast.
- The search inspects an index file to allow to find the terms you are looking for.
- The template is made in Jinja2 (http://jinja.pocoo.org/) which is easy to integrate.
- The design is responsive so the pages are well displayed on smaller screens.
- We can specify which branches we want to build, which will allow to keep an history of previous versions.
If you want to discuss with the team, you can reach us on the Gitter chat dedicated to the Orchard documentation.