Adopt Project and Community section

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

docs/Project and Community/Admin Documentation.rst

@@ -1,3 +1,6 @@
+Admin Documentation
+===================
+
 -  `Aaron Toponce's ZFS on Linux User
    Guide <https://pthree.org/2012/04/17/install-zfs-on-debian-gnulinux/>`__
 -  `OpenZFS System

docs/Project and Community/FAQ.rst

@@ -1,48 +1,8 @@
-Table Of Contents
+FAQ
------------------
+===
 
--  `What is ZFS on Linux <#what-is-zfs-on-linux>`__
+.. contents:: Table of Contents
--  `Hardware Requirements <#hardware-requirements>`__
+   :local:
--  `Do I have to use ECC memory for
-   ZFS? <#do-i-have-to-use-ecc-memory-for-zfs>`__
--  `Installation <#installation>`__
--  `Supported Architectures <#supported-architectures>`__
--  `Supported Kernels <#supported-kernels>`__
--  `32-bit vs 64-bit Systems <#32-bit-vs-64-bit-systems>`__
--  `Booting from ZFS <#booting-from-zfs>`__
--  `Selecting /dev/ names when creating a
-   pool <#selecting-dev-names-when-creating-a-pool>`__
--  `Setting up the /etc/zfs/vdev_id.conf
-   file <#setting-up-the-etczfsvdev_idconf-file>`__
--  `Changing /dev/ names on an existing
-   pool <#changing-dev-names-on-an-existing-pool>`__
--  `The /etc/zfs/zpool.cache file <#the-etczfszpoolcache-file>`__
--  `Generating a new /etc/zfs/zpool.cache
-   file <#generating-a-new-etczfszpoolcache-file>`__
--  `Sending and Receiving Streams <#sending-and-receiving-streams>`__
-
-   -  `hole_birth Bugs <#hole_birth-bugs>`__
-   -  `Sending Large Blocks <#sending-large-blocks>`__
-
--  `CEPH/ZFS <#cephzfs>`__
-
-   -  `ZFS Configuration <#zfs-configuration>`__
-   -  `CEPH Configuration (ceph.conf} <#ceph-configuration-cephconf>`__
-   -  `Other General Guidelines <#other-general-guidelines>`__
-
--  `Performance Considerations <#performance-considerations>`__
--  `Advanced Format Disks <#advanced-format-disks>`__
--  `ZVOL used space larger than
-   expected <#ZVOL-used-space-larger-than-expected>`__
--  `Using a zvol for a swap device <#using-a-zvol-for-a-swap-device>`__
--  `Using ZFS on Xen Hypervisor or Xen
-   Dom0 <#using-zfs-on-xen-hypervisor-or-xen-dom0>`__
--  `udisks2 creates /dev/mapper/ entries for
-   zvol <#udisks2-creating-devmapper-entries-for-zvol>`__
--  `Licensing <#licensing>`__
--  `Reporting a problem <#reporting-a-problem>`__
--  `Does ZFS on Linux have a Code of
-   Conduct? <#does-zfs-on-linux-have-a-code-of-conduct>`__
 
 What is ZFS on Linux
 --------------------
@@ -94,7 +54,7 @@ Installation
 ------------
 
 ZFS on Linux is available for all major Linux distributions. Refer to
-the [[getting started]] section of the wiki for links to installations
+the :doc:`getting started <../Getting Started/index>` section of the wiki for links to installations
 instructions for many popular distributions. If your distribution isn't
 listed you can always build ZFS on Linux from the latest official
 `tarball <https://github.com/zfsonlinux/zfs/releases>`__.
@@ -153,7 +113,9 @@ Booting from ZFS
 ----------------
 
 Booting from ZFS on Linux is possible and many people do it. There are
-excellent walk throughs available for [[Debian]], [[Ubuntu]] and
+excellent walk throughs available for
+:doc:`Debian <../Getting Started/Debian/index>`,
+:doc:`Ubuntu <../Getting Started/Ubuntu/index>`, and
 `Gentoo <https://github.com/pendor/gentoo-zfs-install/tree/master/install>`__.
 
 Selecting /dev/ names when creating a pool
@@ -424,7 +386,7 @@ will not match the source*.
 ZoL versions 0.6.5.8 and 0.7.0-rc1 (and above) default to ignoring the
 faulty metadata which causes this issue *on the sender side*.
 
-For more details, see the [[hole_birth FAQ]].
+For more details, see the :doc:`hole_birth FAQ <./FAQ hole birth>`.
 
 Sending Large Blocks
 ~~~~~~~~~~~~~~~~~~~~

docs/Project and Community/Mailing Lists.rst

@@ -1,27 +1,30 @@
+Mailing Lists
+=============
+
 +----------------------+----------------------+----------------------+
 |                      | Description          | List Archive         |
 |             List     |                      |                      |
 |                      |                      |                      |
 +======================+======================+======================+
-| `zfs-annou           | A low-traffic list   | `arch                |
+| `zfs-announce\       | A low-traffic list   | `archive             |
-| nce@list.zfsonlinux. | for announcements    | ive <https://zfsonli |
+| @list.zfsonlinux.    | for announcements    | <https://zfsonli     |
 | org <https://zfsonli | such as new releases | nux.topicbox.com/gro |
 | nux.topicbox.com/gro |                      | ups/zfs-announce>`__ |
 | ups/zfs-announce>`__ |                      |                      |
 +----------------------+----------------------+----------------------+
-| `zfs-dis             | A user discussion    | `arc                 |
+| `zfs-discuss\        | A user discussion    | `archive             |
-| cuss@list.zfsonlinux | list for issues      | hive <https://zfsonl |
+| @list.zfsonlinux     | list for issues      | <https://zfsonl      |
 | .org <https://zfsonl | related to           | inux.topicbox.com/gr |
 | inux.topicbox.com/gr | functionality and    | oups/zfs-discuss>`__ |
 | oups/zfs-discuss>`__ | usability            |                      |
 +----------------------+----------------------+----------------------+
-| `zfs                 | A development list   | `a                   |
+| `zfs\                | A development list   | `archive             |
-| -devel@list.zfsonlin | for developers to    | rchive <https://zfso |
+| -devel@list.zfsonlin | for developers to    | <https://zfso        |
 | ux.org <https://zfso | discuss technical    | nlinux.topicbox.com/ |
 | nlinux.topicbox.com/ | issues               | groups/zfs-devel>`__ |
 | groups/zfs-devel>`__ |                      |                      |
 +----------------------+----------------------+----------------------+
-| `devel               | A                    | `archive <https://o  |
+| `devel\              | A                    | `archive <https://o  |
 | oper@open-zfs.org <h | platform-independent | penzfs.topicbox.com/ |
 | ttp://open-zfs.org/w | mailing list for ZFS | groups/developer>`__ |
 | iki/Mailing_list>`__ | developers to review |                      |

docs/Project and Community/Signing Keys.rst

@@ -1,3 +1,6 @@
+Signing Keys
+============
+
 All tagged ZFS on Linux
 `releases <https://github.com/zfsonlinux/zfs/releases>`__ are signed by
 the official maintainer for that branch. These signatures are

docs/Project and Community/index.rst

@@ -0,0 +1,12 @@
+Project and Community
+=====================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+   :glob:
+
+   *
+   Issue Tracker <https://github.com/openzfs/zfs/issues>
+   Releases <https://github.com/openzfs/zfs/releases>
+   Roadmap <https://github.com/openzfs/zfs/milestones>

docs/Project-and-Community.rst

@@ -1,24 +0,0 @@
-OpenZFS is storage software which combines the functionality of
-traditional filesystems, volume manager, and more. OpenZFS includes
-protection against data corruption, support for high storage capacities,
-efficient data compression, snapshots and copy-on-write clones,
-continuous integrity checking and automatic repair, remote replication
-with ZFS send and receive, and RAID-Z.
-
-OpenZFS brings together developers from the illumos, Linux, FreeBSD and
-OS X platforms, and a wide range of companies -- both online and at the
-annual OpenZFS Developer Summit. High-level goals of the project include
-raising awareness of the quality, utility and availability of
-open-source implementations of ZFS, encouraging open communication about
-ongoing efforts toward improving open-source variants of ZFS, and
-ensuring consistent reliability, functionality and performance of all
-distributions of ZFS.
-
-| `Admin
-  Documentation <https://pthree.org/2012/04/17/install-zfs-on-debian-gnulinux/>`__
-| [[FAQ]]
-| [[Mailing Lists]]
-| `Releases <https://github.com/zfsonlinux/zfs/releases>`__
-| `Issue Tracker <https://github.com/zfsonlinux/zfs/issues>`__
-| `Roadmap <https://github.com/zfsonlinux/zfs/milestones>`__
-| [[Signing Keys]]