Anonymous user
Category:Pedias: Difference between revisions
add comparison to other main resource types
imported>Nix m (Nix moved page Category:Discussion to Category:Pedias: Discussion implies dialogue, not encyclopedic text. There are already discussion pages. Pedias is an abbreviation of encyclopedia.) |
imported>Nix (add comparison to other main resource types) |
||
| 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 === | === Writing Pedias === | ||
| 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. | # ''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. | # ''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]]. | |||