summary refs log tree commit diff
path: root/nixos/doc/manual/preface.xml
blob: 6ac9ae7e7861d1aa86ba1aa40a5c55b76531f2cc (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
<preface xmlns="http://docbook.org/ns/docbook"
         xmlns:xlink="http://www.w3.org/1999/xlink"
         xml:id="preface">
 <title>Preface</title>
 <para>
  This manual describes how to install, use and extend NixOS, a Linux
  distribution based on the purely functional package management system
  <link xlink:href="https://nixos.org/nix">Nix</link>, that is composed
  using modules and packages defined in the
  <link xlink:href="https://nixos.org/nixpkgs">Nixpkgs</link> project.
 </para>
 <para>
  Additional information regarding the Nix package manager and the Nixpkgs
  project can be found in respectively the
  <link xlink:href="https://nixos.org/nix/manual">Nix manual</link> and the
  <link xlink:href="https://nixos.org/nixpkgs/manual">Nixpkgs manual</link>.
 </para>
 <para>
  If you encounter problems, please report them on the
  <literal
   xlink:href="https://discourse.nixos.org">Discourse</literal> or
  on the <link
   xlink:href="irc://irc.freenode.net/#nixos">
  <literal>#nixos</literal> channel on Freenode</link>. Bugs should be
  reported in
  <link
   xlink:href="https://github.com/NixOS/nixpkgs/issues">NixOS’
  GitHub issue tracker</link>.
 </para>
 <note>
  <para>
   Commands prefixed with <literal>#</literal> have to be run as root, either
   requiring to login as root user or temporarily switching to it using
   <literal>sudo</literal> for example.
  </para>
 </note>
</preface>