Merge pull request #11 from DeterminateSystems/revamp-introduction

Change title in introduction

doc/manual/redirects.js

@@ -275,7 +275,6 @@ const redirects = {
     "ssec-multi-user": "installation/multi-user.html",
     "sec-obtaining-source": "installation/obtaining-source.html",
     "sec-prerequisites-source": "installation/prerequisites-source.html",
-    "ch-supported-platforms": "installation/supported-platforms.html",
     "ch-upgrading-nix": "installation/upgrading.html",
     "ch-about-nix": "introduction.html",
     "chap-introduction": "introduction.html",

doc/manual/source/SUMMARY.md.in

@@ -3,7 +3,6 @@
 - [Introduction](introduction.md)
 - [Quick Start](quick-start.md)
 - [Installation](installation/index.md)
-  - [Supported Platforms](installation/supported-platforms.md)
   - [Installing Nix from Source](installation/installing-source.md)
     - [Prerequisites](installation/prerequisites-source.md)
     - [Obtaining a Source Distribution](installation/obtaining-source.md)

doc/manual/source/installation/index.md

@@ -1,10 +1,10 @@
 # Installation
 
-We recommend that macOS users install Determinate Nix using [Determinate.pkg][pkg].
+We recommend that macOS users install Determinate Nix using our graphical installer, [Determinate.pkg][pkg].
 For Linux and Windows Subsystem for Linux (WSL) users:
 
 ```console
-$ curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | \
+curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | \
   sh -s -- install --determinate
 ```
 

doc/manual/source/installation/supported-platforms.md

@@ -1,7 +0,0 @@
-# Supported Platforms
-
-Nix is currently supported on the following platforms:
-
-  - Linux (i686, x86\_64, aarch64).
-
-  - macOS (x86\_64, aarch64).

doc/manual/source/introduction.md

@@ -1,7 +1,21 @@
-# Introduction
+# Determinate Nix
 
-Nix is a _purely functional package manager_.  This means that it
+**Determinate Nix** is a downstream distribution of [Nix], a purely functional language, CLI tool, and package management system.
-treats packages like values in purely functional programming languages
+It's available on Linux, macOS, and Windows Subsystem for Linux (WSL).
+
+## Installing
+
+We recommend that macOS users install Determinate Nix using our graphical installer, [Determinate.pkg][pkg].
+For Linux and Windows Subsystem for Linux (WSL) users:
+
+```console
+curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | \
+  sh -s -- install --determinate
+```
+
+## How Nix works
+
+Nix treats packages like values in purely functional programming languages
 such as Haskell — they are built by functions that don’t have
 side-effects, and they never change after they have been built.  Nix
 stores packages in the _Nix store_, usually the directory
@@ -184,10 +198,14 @@ to build configuration files in `/etc`).  This means, among other
 things, that it is easy to roll back the entire configuration of the
 system to an earlier state.  Also, users can install software without
 root privileges.  For more information and downloads, see the [NixOS
-homepage](https://nixos.org/).
+homepage][nix].
 
 ## License
 
 Nix is released under the terms of the [GNU LGPLv2.1 or (at your
 option) any later
-version](http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html).
+version][license].
+
+[license]: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html
+[pkg]: https://install.determinate.systems/determinate-pkg/stable/Universal
+[site]: https://nixos.org

doc/manual/source/quick-start.md

@@ -4,7 +4,7 @@ This chapter is for impatient people who don't like reading documentation.
 For more in-depth information you are kindly referred to subsequent chapters.
 
 1. Install Nix.
-   We recommend that macOS users install Determinate Nix using [Determinate.pkg][pkg].
+   We recommend that macOS users install Determinate Nix using our graphical installer, [Determinate.pkg][pkg].
    For Linux and Windows Subsystem for Linux (WSL) users:
 
    ```console