Adopt Getting Started section

Signed-off-by: George Melikov <mail@gmelikov.ru>

docs/Debian-Buster-Encrypted-Root-on-ZFS.rst

@@ -1,47 +0,0 @@
-This experimental guide has been made official at [[Debian Buster Root
-on ZFS]].
-
-If you have an existing system installed from the experimental guide,
-adjust your sources:
-
-::
-
-   vi /etc/apt/sources.list.d/buster-backports.list
-   deb http://deb.debian.org/debian buster-backports main contrib
-   deb-src http://deb.debian.org/debian buster-backports main contrib
-
-   vi /etc/apt/preferences.d/90_zfs
-   Package: libnvpair1linux libuutil1linux libzfs2linux libzpool2linux zfs-dkms zfs-initramfs zfs-test zfsutils-linux zfs-zed
-   Pin: release n=buster-backports
-   Pin-Priority: 990
-
-This will allow you to upgrade from the locally-built packages to the
-official buster-backports packages.
-
-You should set a root password before upgrading:
-
-::
-
-   passwd
-
-Apply updates:
-
-::
-
-   apt update
-   apt dist-upgrade
-
-Reboot:
-
-::
-
-   reboot
-
-If the bpool fails to import, then enter the rescue shell (which
-requires a root password) and run:
-
-::
-
-   zpool import -f bpool
-   zpool export bpool
-   reboot

docs/Getting Started/Debian/Debian Buster Root on ZFS.rst

@@ -1,3 +1,9 @@
+Debian Buster Root on ZFS
+=========================
+
+.. contents:: Table of Contents
+   :local:
+
 Caution
 ~~~~~~~
 

docs/Getting Started/Debian/Debian GNU Linux initrd documentation.rst

@@ -1,5 +1,8 @@
+Debian GNU Linux initrd documentation
+=====================================
+
 Supported boot parameters
-=========================
+*************************
 
 -  rollback=<on|yes|1> Do a rollback of specified snapshot.
 -  zfs_debug=<on|yes|1> Debug the initrd script
@@ -21,7 +24,7 @@ filesystem, is that there are a lot of different ways too boot ZFS out
 there, and I wanted to make sure I supported them all.
 
 Pool imports
-============
+************
 
 Import using /dev/disk/by-\*
 ----------------------------
@@ -47,7 +50,7 @@ If that ALSO fails, it will try one more time, without any -d or -c
 options.
 
 Booting
-=======
+*******
 
 Booting from snapshot:
 ----------------------

docs/Getting Started/Debian/Debian Stretch Root on ZFS.rst

@@ -1,7 +1,13 @@
+Debian Stretch Root on ZFS
+==========================
+
+.. contents:: Table of Contents
+   :local:
+
 Newer release available
 ~~~~~~~~~~~~~~~~~~~~~~~
 
--  See [[Debian Buster Root on ZFS]] for new installs.
+-  See :doc:`Debian Buster Root on ZFS <./Debian Buster Root on ZFS>` for new installs.
 
 Caution
 ~~~~~~~

docs/Getting Started/Debian/index.rst

@@ -1,4 +1,6 @@
-Offical ZFS on Linux
+Debian
+======
+
 `DKMS <https://en.wikipedia.org/wiki/Dynamic_Kernel_Module_Support>`__
 style packages are available from the `Debian GNU/Linux
 repository <https://tracker.debian.org/pkg/zfs-linux>`__ for the
@@ -9,11 +11,8 @@ new installations.
 **Debian Releases:** Stretch (oldstable), Buster (stable), and newer
 (testing, sid) **Architectures:** amd64
 
-Table of contents
+.. contents:: Table of Contents
-=================
+   :local:
-
--  `Installation <#installation>`__
--  `Related Links <#related-links>`__
 
 Installation
 ------------
@@ -21,9 +20,11 @@ Installation
 For Debian Buster, ZFS packages are included in the `contrib
 repository <https://packages.debian.org/source/buster/zfs-linux>`__.
 
-If you want to boot from ZFS, see [[Debian Buster Root on ZFS]] instead.
+If you want to boot from ZFS, see
-For troubleshooting existing installations on Stretch, see [[Debian
+:doc:`Debian Buster Root on ZFS <./Debian Buster Root on ZFS>`
-Stretch Root on ZFS]].
+instead.
+For troubleshooting existing installations on Stretch, see
+:doc:`Debian Stretch Root on ZFS <./Debian Stretch Root on ZFS>`.
 
 The `backports
 repository <https://backports.debian.org/Instructions/>`__ often
@@ -60,8 +61,17 @@ Install the zfs packages:
 
    # apt-get install zfs-dkms zfsutils-linux
 
-Related Links
+Root on ZFS
--------------
+-----------
+.. toctree::
+   :maxdepth: 1
+   :glob:
 
--  [[Debian GNU Linux initrd documentation]]
+   *Root on ZFS
--  [[Debian Buster Root on ZFS]]
+
+Related topics
+--------------
+.. toctree::
+   :maxdepth: 1
+
+   Debian GNU Linux initrd documentation

docs/Getting Started/Fedora.rst

@@ -1,3 +1,6 @@
+Fedora
+======
+
 Only
 `DKMS <https://en.wikipedia.org/wiki/Dynamic_Kernel_Module_Support>`__
 style packages can be provided for Fedora from the official

docs/Getting Started/RHEL and CentOS.rst

@@ -1,3 +1,6 @@
+RHEL and CentOS
+===============
+
 `kABI-tracking
 kmod <http://elrepoproject.blogspot.com/2016/02/kabi-tracking-kmod-packages.html>`__
 or

docs/Getting Started/Ubuntu/Ubuntu 16.04 Root on ZFS.rst

@@ -1,7 +1,13 @@
+Ubuntu 16.04 Root on ZFS
+========================
+
+.. contents:: Table of Contents
+   :local:
+
 Newer release available
 ~~~~~~~~~~~~~~~~~~~~~~~
 
--  See [[Ubuntu 18.04 Root on ZFS]] for new installs.
+-  See :doc:`Ubuntu 18.04 Root on ZFS <./Ubuntu 18.04 Root on ZFS>` for new installs.
 
 Caution
 ~~~~~~~

docs/Getting Started/Ubuntu/Ubuntu 18.04 Root on ZFS.rst

@@ -1,3 +1,9 @@
+Ubuntu 18.04 Root on ZFS
+========================
+
+.. contents:: Table of Contents
+   :local:
+
 Caution
 ~~~~~~~
 

docs/Getting Started/Ubuntu/index.rst

@@ -0,0 +1,13 @@
+Ubuntu
+======
+
+ZFS packages are `provided by the
+distribution <https://wiki.ubuntu.com/Kernel/Reference/ZFS>`__.
+
+Root on ZFS
+-----------
+.. toctree::
+   :maxdepth: 1
+   :glob:
+
+   *

docs/Getting Started/index.rst

@@ -1,14 +1,21 @@
+Getting Started
+===============
+
 To get started with OpenZFS refer to the provided documentation for your
 distribution. It will cover the recommended installation method and any
 distribution specific information. First time OpenZFS users are
 encouraged to check out Aaron Toponce's `excellent
 documentation <https://pthree.org/2012/04/17/install-zfs-on-debian-gnulinux/>`__.
 
-| `ArchLinux <https://wiki.archlinux.org/index.php/ZFS>`__
+.. toctree::
-| [[Debian]]
+   :maxdepth: 3
-| [[Fedora]]
+   :glob:
-| `FreeBSD <https://zfsonfreebsd.github.io/ZoF/>`__
+
-| `Gentoo <https://wiki.gentoo.org/wiki/ZFS>`__
+   ArchLinux <https://wiki.archlinux.org/index.php/ZFS>
-| `openSUSE <https://software.opensuse.org/package/zfs>`__
+   Debian/index
-| [[RHEL and CentOS]]
+   Fedora
-| [[Ubuntu]]
+   FreeBSD <https://zfsonfreebsd.github.io/ZoF/>
+   Gentoo <https://wiki.gentoo.org/wiki/ZFS>
+   openSUSE <https://software.opensuse.org/package/zfs>
+   RHEL and CentOS
+   Ubuntu/index

docs/HOWTO-install-Debian-GNU-Linux-to-a-Native-ZFS-Root-Filesystem.rst

@@ -1 +0,0 @@
-This page has moved to [[Debian Jessie Root on ZFS]].

docs/Ubuntu.rst

@@ -1,10 +0,0 @@
-ZFS packages are `provided by the
-distribution <https://wiki.ubuntu.com/Kernel/Reference/ZFS>`__.
-
-If you want to use ZFS as your root filesystem, see these instructions:
-
--  [[Ubuntu 18.04 Root on ZFS]]
-
-For troubleshooting existing installations, see:
-
--  16.04: [[Ubuntu 16.04 Root on ZFS]]