Date: 2017-06-08
Accepted
Project documentation is formatted using HTML. Documentation is accessible only online. A browser is needed to read the pages. Too much noise around the important text. Documentation can differ from the version bundled with the project, usually not updated online. Update needs HTML editing/formatting/reformatting. Not portable.
Use the markdown syntax to format documentation.
Following industry standards. Offline readable. Minimal formatting of the text. Only a text editor needed to read/write. IDE support for display and edit (e.g.: IntelliJ IDEA products). Easy to bundle with any project.