Category:Guide: Difference between revisions

From NixOS Wiki
imported>Makefu
m Makefu moved page Category:How-To to Category:Guide without leaving a redirect: Rename
imported>Nix
Updating description to be more in line with typical usage of "guide", with regards to reference sites like this wiki. Add comparison to other major resource types
Line 1: Line 1:
How-to guides take the reader through the steps required to solve a real-world problem.
''Guide'' is one of the five primary [[Resources|resource]] categories for the wiki.


They are recipes, directions to achieve a specific end - for example: how to create a web form; how to plot a three-dimensional data-set; how to enable LDAP authentication.
=== Guide scope ===


They are wholly '''goal-oriented'''.
''Guide'' can mean [https://en.wikipedia.org/wiki/Guide_(disambiguation) many things]. In our case, we look at ''guides'' as a sort of reference work. To understand what pages might be considered ''guides'', look to these sources in particular:


If you'd like an analogy, think about a ''recipe, for preparing something to eat''.
# [https://en.wikipedia.org/wiki/Compendium Compendium] - "''... a concise collection of information pertaining to a body of knowledge. A compendium may summarize a larger work.''"
# [https://en.wikipedia.org/wiki/Study_guide Study guide] - ''"Study guides can be broad based to facilitate learning in a number of areas, or be resources that foster comprehension... Some will summarize ... the important elements of the subject.''"
# [https://en.wikipedia.org/wiki/Guide_to_information_sources Guide to information sources] - ''"... (or a bibliographic guide, a literature guide, a guide to reference materials, a subject gateway, etc.) is a kind of metabibliography. Ideally it is not just a listing of bibliographies, reference works and other information sources, but more like a textbook introducing users to the information sources in a given field (in general)."''
 
=== Comparison to other resource page types ===
 
* If information is more encyclopedic (with a similar scope and tone to pages on [https://www.wikipedia.org/ Wikipedia]), a page would be considered a [[:Category:Pedias|pedia]].
* 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, it would fit under [[:Category:reference|references]].

Revision as of 01:06, 20 September 2021

Guide is one of the five primary resource categories for the wiki.

Guide scope

Guide can mean many things. In our case, we look at guides as a sort of reference work. To understand what pages might be considered guides, look to these sources in particular:

  1. Compendium - "... a concise collection of information pertaining to a body of knowledge. A compendium may summarize a larger work."
  2. Study guide - "Study guides can be broad based to facilitate learning in a number of areas, or be resources that foster comprehension... Some will summarize ... the important elements of the subject."
  3. Guide to information sources - "... (or a bibliographic guide, a literature guide, a guide to reference materials, a subject gateway, etc.) is a kind of metabibliography. Ideally it is not just a listing of bibliographies, reference works and other information sources, but more like a textbook introducing users to the information sources in a given field (in general)."

Comparison to other resource page types

  • If information is more encyclopedic (with a similar scope and tone to pages on Wikipedia), a page would be considered a pedia.
  • If information is more about direct instruction to achieve a specific task, a page would be considered a tutorial.
  • If a page is more just a set of tips and tricks (less instructive than a tutorial), it would be a cookbook.
  • If a page is a detailed reference, it would fit under references.