Category:Pedias

Discussions are understanding-oriented articles aimed at explaining a particular topic. They are encyclopedic, 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.

Canonical Forms

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.

Software

Software articles cover a software package, application or library. The following sections are listed from greatest to least importance:

1. Introduction: a general overview

1. Usage: a practical overview of different approaches to installing, configuring and operating the software, linking to more comprehensive guides.

1. Internals: a theoretical overview of the internal architecture of the software, including critical files and directories, processes and objects.

1. Development: a project overview for potential contributors, including an overview of the source-code directory structure, development process, issue tracking and the developer community.

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