README.md

   1 # Introduction
   2
   3 This is a collection of design documents, formerly maintained in various
   4 different locations and formats, now grouped together and converted
   5 to commonmark.
   6
   7 # Contributing
   8
   9 ## Style
  10
  11 We will follow the commonmark specification.
  12
  13 We *should* try to follow this
  14 [style guide](http://www.cirosantilli.com/markdown-style-guide/#about),
  15 but are still [evaluating solutions](https://github.com/jgm/cmark/issues/131)
  16 for *stable* automatic formatting.
  17
  18 80 columns line width is thus not yet enforced, but strongly suggested.
  19
  20 # Build a web portal from the sources
  21
  22 ## Install dependencies
  23
  24 * Follow [hotdoc's installation guide](https://people.collabora.com/~meh/hotdoc_hotdoc/html/installing.html),
  25   preferably in a virtualenv.
  26
  27 * We *experimentally* use the hotdoc C extension to include functions by
  28   name, follow the steps outlined [here](https://github.com/hotdoc/hotdoc_c_extension)
  29
  30 * Build the portal:
  31
  32 ```
  33 make
  34 ```
  35
  36 * And browse it:
  37
  38 ```
  39 gio open built_doc/html/index.html
  40 ```
  41
  42 ## Licensing
  43
  44 The content of this module comes from a number of different sources and is
  45 licensed in different ways:
  46
  47 ### Tutorial source code
  48
  49 All tutorial code is licensed under any of the following licenses (your choice):
  50
  51  - 2-clause BSD license ("simplified BSD license") (`LICENSE.BSD`)
  52  - MIT license (`LICENSE.MIT`)
  53  - LGPL v2.1 (`LICENSE.LGPL-2.1`)
  54
  55 This means developers have maximum flexibility and can pick the right license
  56 for any derivative work.
  57
  58 ### Application Developer Manual and Plugin Writer's Guide
  59
  60 These are licensed under the [Open Publication License v1.0][op-license]
  61 (`LICENSE.OPL`), for historical reasons.
  62
  63 [op-license]: http://www.opencontent.org/openpub/
  64
  65 ### Documentation
  66
  67 Mostly licensed under the [Creative Commons CC-BY-SA-4.0 license][cc-by-sa-4.0],
  68 but some parts of the documentation may still be licensed differently
  69 (e.g. LGPLv2.1) for historical reasons.
  70
  71 [cc-by-sa-4.0]: https://creativecommons.org/licenses/by-sa/4.0/