Official NixOS Wiki:Contributing: Difference between revisions

Line 14:

===Language===

~~Discussion~~ 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:

* ''Vocabulary'': use the simplest and most conventional words and expressions you can find to get your point across without oversimplifying.

Line 20:

* ''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.

* ''Code'': code examples should be ~~cogent~~ and illustrative of the surrounding text ~~(otherwise they would normally go in one of the other article types)~~.

* ''Code'': code examples should be minimal, to-the-point, and illustrative of the surrounding text.

== Tagging Articles ==

@@ Line 14: / Line 14: @@
 ===Language===
-Discussion 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:
 * ''Vocabulary'': use the simplest and most conventional words and expressions you can find to get your point across without oversimplifying.
@@ Line 20: / Line 20: @@
 * ''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.
-* ''Code'': code examples should be cogent and illustrative of the surrounding text (otherwise they would normally go in one of the other article types).
+* ''Code'': code examples should be minimal, to-the-point, and illustrative of the surrounding text.
 == Tagging Articles ==