"Fossies" - the Fresh Open Source Software Archive
Member "ILIAS-5.4.9/docs/documentation/docs-guidelines.md" (24 Jan 2020, 2896 Bytes) of package /linux/www/ILIAS-5.4.9.tar.gz:
As a special service "Fossies" has tried to format the requested source page into HTML format (assuming markdown format).
Alternatively you can here view
the uninterpreted source code file.
A member file download can also be achieved by clicking within a package contents listing on the according byte size field.
This guidelines direct authors in creating, naming and writing files providing information such as guidelines, how-tos, tutorials, examples or abouts. If you want to propose changes to any of the doc files, please make a PR agains trunk and label it with ‘JourFixe’. Further, please consult the contributing guideline for more information about collaborating in this project.
When such new information is to be added, the following points need to be considered concerning the location of this information:
- If information that applies to exactly one directory of the ILIAS repo is provided then a file named
README.md MUST be created in this exact directory and the new information MUST be added there.
- Each folder except docs and it’s descendants MUST only contain at most one md file, named
- Information of general nature or not concerning strictly one directory MUST be placed in the docs folder or even better in one of the following sub directories of docs if applicable:
- documentation: For examples, tutorials, explanations and guidelines covering cross-sectional matters. Mostly for contributors.
- configuration: For How-Tos, FAQs installation instructions or similar. Mostly for administrators.
- Any information essential for either running ILIAS or contributing to ILIAS SHOULD at least be linked in the global
README.md file placed in the main directory of the ILIAS repo.
- Files providing information for one exact folder MUST be named README.md.
- Only the following files MUST be written in uppercase:
- All other files MUST be written in lowercase.
- Names containing more than one word MUST use hyphens to separate the words (such as docs-guidelines).
- The file extension for all markdown files MUST be
- Markdown SHOULD be used for providing information such as described above.
- A Table of Content (TOC) with links to all headlines SHOULD be included.
- RFC2119 SHOULD be used when writing guidelines to signify their level of requirement.
- In Guidelines the audience SHOULD NOT be addressed directly (e.g. do not start with “You SHOULD”).
- In how-to, tutorials or similar, the audience MAY be addressed directly.
- If contend from other files is referenced an internal link to this document SHOULD be provided.
- Line wrap after around 80 chars per line to improve readability SHOULD be used.
Table of Contents (Markdown)
To maintain a TOC the Sublime Edit plugin MarkdownTOC MAY be used, other Tools are welcome as well. If MarkdownTOC is used, the TOC SHOULD be initiated with the following attributes:
<!-- MarkdownTOC depth=0 autolink="true" bracket="round" autoanchor="true" style="ordered" indent=" " -->