Category:Pedias: Difference between revisions

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.

Pedias (abbreviation of "encyclopedia") 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 ''pedia'' article might be read casually for leisure, rather than being used as [[:Category:Reference|reference]] while coding.

=== Writing ~~Discussions~~ ===

=== Writing Pedias ===

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

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

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

; Overview: ''Pedias'' 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.

; Diversity: ''Pedias'' 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.

; Focus: ''Pedias'' 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:

While in general, ''pedia'' 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:

# ''Introduction'': a general overview.