Category:Pedias: Difference between revisions

From NixOS Wiki
imported>Makefu
Created page with "Discussions, or explanations, clarify and illuminate a particular topic. They broaden the documentation’s coverage of a topic. They are '''understanding-oriented'''. Discu..."
 
imported>Ixxie
Recast the same information as a cohesive paragraph.
Line 1: Line 1:
Discussions, or explanations, clarify and illuminate a particular topic. They broaden the documentation’s coverage of a topic.
Discussions are ''understanding-oriented'' articles aimed at explaining a particular topic. They are intended to provide an overview of the subject at hand, illuminating the big picture and various perspectives of it. A discussion article might be read casually for leisure, rather than being used as [[:Category:Reference|reference]] while coding.
 
They are '''understanding-oriented'''.
 
Discussions can equally well be described as explanations. They are a chance for the documentation to relax and step back from the software, taking a wider view, illuminating it from a higher level or even from different perspectives. You might imagine a discussion document being read at leisure, rather than over the code.

Revision as of 16:57, 29 August 2017

Discussions are understanding-oriented articles aimed at explaining a particular topic. They are intended to provide an overview of the subject at hand, illuminating the big picture and various perspectives of it. A discussion article might be read casually for leisure, rather than being used as reference while coding.