NixOS Wiki:Contributing: Difference between revisions
imported>Fadenb m (→Syntax) |
imported>Ixxie (Added accessibility to language style guide.) |
||
Line 20: | Line 20: | ||
== Style == | == Style == | ||
=== Language === | === Language === | ||
NixOS Wiki articles should be written in clear, standard and professional language. To this end, the following considerations apply: | NixOS Wiki articles should be written in clear, standard and professional language. To this end, the following considerations apply: | ||
* ''Accessibility'': Wiki articles are often the first thing a new user will read about any subject, so they should be accessible to beginners. | |||
* ''Vocabulary'': Use the simplest and most conventional words and expressions you can find to get your point across without oversimplifying. | |||
* ''Organization'': Keep your text structured in coherent sentences, paragraphs and sections, each with its own clear themes and topics. | |||
* ''Citations'': Citations aren't required, but definitely appreciated; when citing code, hardlink to a particular revision. | |||
* ''Attribution'': Where external material is quoted or utilized in the article, and/or licensing or common sense demands it, place clear and complete attribution and (where possible) a link. | |||
=== Syntax === | === Syntax === |