Category:Pedias: Difference between revisions
imported>Ixxie Added more clauses to language section. |
imported>Ixxie No edit summary |
||
| Line 1: | Line 1: | ||
Discussions are ''understanding-oriented'' articles aimed at explaining a particular topic. They are encyclopedic, intended to provide an overview of the subject at hand, illuminating the big picture and various perspectives of it. A discussion article might be read casually for leisure, rather than being used as [[:Category:Reference|reference]] while coding. | Discussions are ''understanding-oriented'' articles aimed at explaining a particular topic. They are encyclopedic, intended to provide an overview of the subject at hand, illuminating the big picture and various perspectives of it. A discussion article might be read casually for leisure, rather than being used as [[:Category:Reference|reference]] while coding. | ||
=Style= | ==Style== | ||
==Language== | ===Language=== | ||
Discussion articles should be written in clear, standard and professional language. To this end, the following considerations apply: | Discussion articles should be written in clear, standard and professional language. To this end, the following considerations apply: | ||
| Line 13: | Line 13: | ||
* ''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 cogent and illustrative of the surrounding text (otherwise they would normally go in one of the other article types). | ||
==Canonical Forms== | ===Canonical Forms=== | ||
While in general, discussion articles can take a wide variety of forms, certain types of articles recur in the NixOS wiki and warrant specific formats. For these we provide ''canonical forms'', recommended templates for structuring these types of discussion articles. | While in general, discussion articles can take a wide variety of forms, certain types of articles recur in the NixOS wiki and warrant specific formats. For these we provide ''canonical forms'', recommended templates for structuring these types of discussion articles. | ||
===Software=== | ====Software==== | ||
Software articles cover a software package, application or library. The following sections are listed from greatest to least importance: | Software articles cover a software package, application or library. The following sections are listed from greatest to least importance: | ||