Category:Pedias - Revision history

Klinger: /* Writing Pedias */ Changed link to MoS

2024-09-02T20:05:43Z

Writing Pedias: Changed link to MoS

← Older revision		Revision as of 20:05, 2 September 2024
Line 5:		Line 5:
	=== Writing Pedias ===		=== 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.		; Overview: ''Pedias'' are meant to provide a clear overview of their subject matter, and be accordingly organized into easily navigable sections.

imported>Nix: make pedias a subcategory of "Resource"

2021-09-20T09:07:18Z

make pedias a subcategory of "Resource"

← Older revision		Revision as of 09:07, 20 September 2021
Line 25:		Line 25:
	* 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 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]].		* If a page is a detailed reference (like a man page or full software manual), it would fit under [[:Category:reference\|references]].

			[[Category:Resource]]

imported>Nix: add comparison to other main resource types

2021-09-20T01:12:42Z

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.
 === 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.
 # ''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.

imported>Nix: 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.

2021-09-20T00:23:10Z

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.

← Older revision		Revision as of 00:23, 20 September 2021
(No difference)

imported>Nix: prepare for move to Pedias

2021-09-20T00:22:49Z

prepare for move to Pedias

← Older revision		Revision as of 00:22, 20 September 2021
Line 1:		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.		# ''Introduction'': a general overview.

imported>Ixxie at 17:06, 9 December 2017

2017-12-09T17:06:31Z

← Older revision		Revision as of 17:06, 9 December 2017
Line 5:		Line 5:
	Besides the [[Contributing to the Wiki#Style\|general style considerations]], discussion articles should value:		Besides the [[Contributing to the Wiki#Style\|general style considerations]], discussion 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: Discussions 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: Discussions 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: Discussions 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, 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:

imported>Ixxie at 17:05, 9 December 2017

2017-12-09T17:05:57Z

← Older revision		Revision as of 17:05, 9 December 2017
Line 3:		Line 3:
	=== Writing Discussions ===		=== Writing Discussions ===

	Besides the [[Contributing to the Wiki#Style\|general style considerations]], discussion articles should provide a clear ''overview'' of their subject matter, and be accordingly organized into easily navigable sections. ~~Therefore~~ discussions should ~~be ''diverse'', covering~~ multiple workflows, approaches and perspectives to the topic. ~~However they~~ should maintain ''focus'' on the ~~topic they cover~~, linking to other resources such as dedicated articles when a section starts running too long.		Besides the [[Contributing to the Wiki#Style\|general style considerations]], discussion articles should value:

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

	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, 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:

imported>Ixxie at 17:03, 9 December 2017

2017-12-09T17:03:21Z

← Older revision		Revision as of 17:03, 9 December 2017
Line 1:		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.		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.

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

	Besides the [[Contributing to the Wiki#Style\|general style considerations]], discussion articles should be ~~written with~~ the ~~following considerations in mind:~~		Besides the [[Contributing to the Wiki#Style\|general style considerations]], discussion articles should provide a clear ''overview'' of their subject matter, and be accordingly organized into easily navigable sections. Therefore discussions should be ''diverse'', covering multiple workflows, approaches and perspectives to the topic. However they should maintain ''focus'' on the topic they cover, linking to other resources such as dedicated articles when a section starts running too long.

	* ''Accessibility'': discussions are often the first thing a new user will read about any subject, so they should be accessible to beginners.		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:
	* ''Overview'': discussions must provide a clear overview of their subject matter, and be accordingly organized into easily navigable sections.
	* ''Variety'': related to the previous point, where appropriate discussions should cover multiple workflows, approaches and perspectives to the topic.

	~~=== Canonical Form ===~~

	While in general, discussion articles can take a wide variety of forms, ~~certain types of articles recur in~~ the ~~NixOS wiki and warrant specific formats. For these we provide a~~ ''canonical form'', designed for articles covering a software package, application or ~~library. The following structure is recommended for such articles~~, ~~with~~ the ~~first sections considered most critical~~:

	# ''Introduction'': a general overview.		# ''Introduction'': a general overview.

imported>Ixxie at 16:42, 9 December 2017

2017-12-09T16:42:02Z

← Older revision		Revision as of 16:42, 9 December 2017
Line 1:		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.		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.

	== Style ==		=== Style ===

	Besides the [[Contributing to the Wiki#Style\|general style considerations]], discussion articles should be written with the following considerations in mind:		Besides the [[Contributing to the Wiki#Style\|general style considerations]], discussion articles should be written with the following considerations in mind:
Line 9:		Line 9:
	* ''Variety'': related to the previous point, where appropriate discussions should cover multiple workflows, approaches and perspectives to the topic.		* ''Variety'': related to the previous point, where appropriate discussions should cover multiple workflows, approaches and perspectives to the topic.

	==Canonical Form==		=== Canonical Form ===

	While in general, discussion articles can take a wide variety of forms, certain types of articles recur in the NixOS wiki and warrant specific formats. For these we provide a ''canonical form'', designed for articles covering a software package, application or library. The following structure is recommended for such articles, with the first sections considered most critical:		While in general, discussion articles can take a wide variety of forms, certain types of articles recur in the NixOS wiki and warrant specific formats. For these we provide a ''canonical form'', designed for articles covering a software package, application or library. The following structure is recommended for such articles, with the first sections considered most critical:

imported>Ixxie: /* Canonical Forms */

2017-12-09T16:41:48Z

Canonical Forms

← Older revision		Revision as of 16:41, 9 December 2017
Line 9:		Line 9:
	* ''Variety'': related to the previous point, where appropriate discussions should cover multiple workflows, approaches and perspectives to the topic.		* ''Variety'': related to the previous point, where appropriate discussions should cover multiple workflows, approaches and perspectives to the topic.

	==Canonical ~~Forms~~==		==Canonical Form==

	While in general, discussion articles can take a wide variety of forms, certain types of articles recur in the NixOS wiki and warrant specific formats. For these we provide ''canonical ~~forms~~'', ~~recommended templates~~ for ~~structuring these types of discussion~~ articles.		While in general, discussion articles can take a wide variety of forms, certain types of articles recur in the NixOS wiki and warrant specific formats. For these we provide a ''canonical form'', designed for articles covering a software package, application or library. The following structure is recommended for such articles, with the first sections considered most critical:

	~~===Software===~~

	~~Software articles cover~~ a software package, application or library. The following structure is recommended for such articles, with the first sections considered most critical:

	# ''Introduction'': a general overview.		# ''Introduction'': a general overview.