Category:Pedias: Difference between revisions

Line 3:

=== Writing Discussions ===

Besides the [[Contributing to the Wiki#Style|general style considerations]], discussion articles should provide a clear ''overview'' of their subject matter, and be accordingly organized into easily navigable sections. ~~Therefore~~ discussions should ~~be ''diverse'', covering~~ multiple workflows, approaches and perspectives to the topic. ~~However they~~ should maintain ''focus'' on the ~~topic they cover~~, linking to other resources such as dedicated articles when a section starts running too long.

Besides the [[Contributing to the Wiki#Style|general style considerations]], discussion articles should value:

; Overview: discussions are meant to provide a clear overview of their subject matter, and be accordingly organized into easily navigable sections.

; Diversity: discussions should cover multiple workflows, approaches and perspectives to the topic.

; focus: discussions should maintain focus on the subject at hand, linking to other resources such as dedicated articles when a section starts running too long.

While in general, discussion articles can take a wide variety of forms, the following ''canonical form'' is designed for articles covering a software package, application or libraries, and will often be applicable in the NixOS Wiki:

@@ Line 3: / Line 3: @@
 === Writing Discussions ===
-Besides the [[Contributing to the Wiki#Style|general style considerations]], discussion articles should provide a clear ''overview'' of their subject matter, and be accordingly organized into easily navigable sections. Therefore discussions should be ''diverse'', covering multiple workflows, approaches and perspectives to the topic. However they should maintain ''focus'' on the topic they cover, linking to other resources such as dedicated articles when a section starts running too long.
+Besides the [[Contributing to the Wiki#Style|general style considerations]], discussion articles should value:
+; Overview: discussions are meant to provide a clear overview of their subject matter, and be accordingly organized into easily navigable sections.
+; Diversity: discussions should cover multiple workflows, approaches and perspectives to the topic.
+; focus: discussions should maintain focus on the subject at hand, linking to other resources such as dedicated articles when a section starts running too long.
 While in general, discussion articles can take a wide variety of forms, the following ''canonical form'' is designed for articles covering a software package, application or libraries, and will often be applicable in the NixOS Wiki: