Category:Guide: Difference between revisions

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]].

@@ 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]].