D3.2 Full documentation of all prototypes
  • Introduction
  • How we documented the prototypes
    • How we documented the prototypes
    • Content architecture
    • Home Page
    • Pages
    • About
    • Blog
  • Special Prototype
    • Special Prototype
    • Inpe
    • Open Rampette
  • Community Prototype
    • Community Prototype
    • Allergoki
    • Breathing Game
    • Rehub
    • Voice Instruments
  • Credits
    • Credits
Powered by GitBook
On this page
  1. How we documented the prototypes

How we documented the prototypes

PreviousIntroductionNextContent architecture

Last updated 7 years ago

The documentation is following the best practices of good documentation in the "maker communities" (see also the section: Sharing documentation how to facilitate replicability of processes and results of the .)

The documentation is released using a lot of the features available on Github where many of the open source projects are made public and open to collaboration.

All websites are based on Jekyll ( a simple, blog-aware, static site generator for personal, project, or organization sites distributed under an open source license) and GitHub Pages (a static site hosting service by Github).

This combination of a publishing system and hosting makes it easy to:

  • keep project's documentation and actual project files in the same place, the repository, thanks to GitHub Pages

  • create and publish a variety of content in an easy-to-use language (markdown) and arrange the site layout to match the project's needs, thanks to Jekyll (see also: )

  • foster contributions by a wider audience

opencare Maker Playbook
https://github.com/opencarecc/MicroWebsiteTemplate/wiki/