diff options
author | Mathieu Duponchelle <mathieu.duponchelle@opencreed.com> | 2016-06-04 18:14:27 +0200 |
---|---|---|
committer | Mathieu Duponchelle <mathieu.duponchelle@opencreed.com> | 2016-06-04 18:14:27 +0200 |
commit | 2b89969d950155de97284f0788a26c5c7967a3ae (patch) | |
tree | 0ce2ea4a09ce1667027c04f68bb25fa60d1f401b /README | |
parent | 07c4cc7ddca5d844ddbaff9bf390bb9eee1904e6 (diff) |
Add a README
Feel free to change it if disagreeing, but having something
can't hurt :)
Diffstat (limited to 'README')
-rw-r--r-- | README | 43 |
1 files changed, 43 insertions, 0 deletions
@@ -0,0 +1,43 @@ +# Introduction + +This is a collection of design documents, formerly maintained in various +different locations and formats, now grouped together and converted +to commonmark. + +# Contributing + +## Style + +We will follow the commonmark specification. + +We *should* try to follow this +[style guide](http://www.cirosantilli.com/markdown-style-guide/#about), +but are still [evaluating solutions](https://github.com/jgm/cmark/issues/131) +for *stable* automatic formatting. + +80 columns line width is thus not yet enforced, but strongly suggested. + +# Build a web portal from the sources + +## Install dependencies + +* Follow [hotdoc's installation guide](https://people.collabora.com/~meh/hotdoc_hotdoc/html/installing.html), + preferably in a virtualenv. + +* Optionally install the `hotdoc_search_extension`: + +``` +pip install hotdoc-search-extension +``` + +* Build the portal: + +``` +hotdoc run +``` + +* And browse it: + +``` +xdg-open build/html/index.html +``` |