From 94a8a537cc1a1c3fde3792f811d7e5be892b2bae Mon Sep 17 00:00:00 2001
From: Jean-Paul Calderone <exarkun@twistedmatrix.com>
Date: Wed, 7 Aug 2019 14:42:16 -0400
Subject: [PATCH] Some doc improvements

---
 .circleci/config.yml                | 2 +-
 README.rst                          | 4 +++-
 docs/source/README.rst              | 2 ++
 docs/source/index.rst               | 3 +++
 nixos/{tests.nix => unit-tests.nix} | 0
 5 files changed, 9 insertions(+), 2 deletions(-)
 create mode 100644 docs/source/README.rst
 rename nixos/{tests.nix => unit-tests.nix} (100%)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index b7eb4c30..3256c18d 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -30,7 +30,7 @@ jobs:
       - run:
           name: "Run Tests"
           command: |
-            nix-build nixos/tests.nix && cat result
+            nix-build nixos/unit-tests.nix && cat result
 
   build:
     docker:
diff --git a/README.rst b/README.rst
index f1552d5c..675c9a7f 100644
--- a/README.rst
+++ b/README.rst
@@ -13,7 +13,7 @@ Documentation
 
 The documentation can be built using this command::
 
-  nix-build docs.nix
+  $ nix-build docs.nix
 
 The documentation is also built on and published by CI.
 
@@ -33,3 +33,5 @@ The system tests are run using this command::
   $ nix-build nixos/system-tests.nix
 
 The system tests boot QEMU VMs which prevents them from running on CI at this time.
+
+.. _Nix: https://nixos.org/nix
diff --git a/docs/source/README.rst b/docs/source/README.rst
new file mode 100644
index 00000000..068656cc
--- /dev/null
+++ b/docs/source/README.rst
@@ -0,0 +1,2 @@
+.. include::
+   ../../README.rst
diff --git a/docs/source/index.rst b/docs/source/index.rst
index d06ae0d5..e712e0e4 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -10,8 +10,11 @@ Welcome to PrivateStorageio's documentation!
    :maxdepth: 2
    :caption: Contents:
 
+   README
    architecture-overview
 
+
+
 Indices and tables
 ==================
 
diff --git a/nixos/tests.nix b/nixos/unit-tests.nix
similarity index 100%
rename from nixos/tests.nix
rename to nixos/unit-tests.nix
-- 
GitLab