Category:Pedias: Difference between revisions
imported>Ixxie |
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 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 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 === | ||
Besides the [[Contributing to the Wiki#Style|general style considerations]], discussion articles should be written with the following considerations in mind: | Besides the [[Contributing to the Wiki#Style|general style considerations]], discussion articles should be written with the following considerations in mind: | ||
| Line 9: | Line 9: | ||
* ''Variety'': related to the previous point, where appropriate discussions should cover multiple workflows, approaches and perspectives to the topic. | * ''Variety'': related to the previous point, where appropriate discussions should cover multiple workflows, approaches and perspectives to the topic. | ||
==Canonical Form== | === Canonical Form === | ||
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 a ''canonical form'', designed for articles covering a software package, application or library. The following structure is recommended for such articles, with the first sections considered most critical: | 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 a ''canonical form'', designed for articles covering a software package, application or library. The following structure is recommended for such articles, with the first sections considered most critical: | ||