Category:Pedias: Difference between revisions

(3 intermediate revisions by one other user not shown)

Line 1:

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.

''Pedia'' is one of the five primary [[Resources|resource]] categories for the wiki.

''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 Pedias ===

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

Besides the [[Manual of Style|general style considerations]], pedia articles should value:

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

Line 16:

Line 18:

# ''Development'': a project overview for potential contributors, including an overview of the source-code directory structure, development process, issue tracking and the developer community.

# ''History'': a historical overview of the software, including an overview of the origins and past development of the software, and the broader historical context, such as precedents and antecedents.

=== Comparison to other resource page types ===

* If information is less encyclopedic and more similar to a [https://en.wikipedia.org/wiki/Compendium compendium], [https://en.wikipedia.org/wiki/Study_guide study guide], or a [https://en.wikipedia.org/wiki/Guide_to_information_sources bibliographic guide], a page would be considered a [[:Category:Guide|guide]].

* If information is more about direct instruction to achieve a specific task, a page would be considered a [[:Category:Tutorial|tutorial]].

* If a page is more just a set of tips and tricks (less instructive than a tutorial), it would be a [[:Category:Cookbook|cookbook]].

* If a page is a detailed reference (like a man page or full software manual), it would fit under [[:Category:reference|references]].

[[Category:Resource]]

@@ Line 1: / Line 1: @@
-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.
+''Pedia'' is one of the five primary [[Resources|resource]] categories for the wiki.
+''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 Pedias ===
-Besides the [[Contributing to the Wiki#Style|general style considerations]], pedia articles should value:
+Besides the [[Manual of Style|general style considerations]], pedia articles should value:
 ; Overview: ''Pedias'' are meant to provide a clear overview of their subject matter, and be accordingly organized into easily navigable sections.
@@ Line 16: / Line 18: @@
 # ''Development'': a project overview for potential contributors, including an overview of the source-code directory structure, development process, issue tracking and the developer community.
 # ''History'': a historical overview of the software, including an overview of the origins and past development of the software, and the broader historical context, such as precedents and antecedents.
+=== Comparison to other resource page types ===
+* If information is less encyclopedic and more similar to a [https://en.wikipedia.org/wiki/Compendium compendium], [https://en.wikipedia.org/wiki/Study_guide study guide], or a [https://en.wikipedia.org/wiki/Guide_to_information_sources bibliographic guide], a page would be considered a [[:Category:Guide|guide]].
+* If information is more about direct instruction to achieve a specific task, a page would be considered a [[:Category:Tutorial|tutorial]].
+* If a page is more just a set of tips and tricks (less instructive than a tutorial), it would be a [[:Category:Cookbook|cookbook]].
+* If a page is a detailed reference (like a man page or full software manual), it would fit under [[:Category:reference|references]].
+[[Category:Resource]]