diff options
Diffstat (limited to 'docs/index.rst')
| -rw-r--r-- | docs/index.rst | 72 |
1 files changed, 11 insertions, 61 deletions
diff --git a/docs/index.rst b/docs/index.rst index 7a9ce09..b7fb8d9 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,10 +1,6 @@ Patchwork ========= -.. toctree:: - :maxdepth: 2 - :caption: Contents: - Patchwork is a patch tracking system for community-based projects. It is intended to make the patch management process easier for both the project's contributors and maintainers, leaving time for the more important (and more @@ -21,61 +17,15 @@ subsystems of the Linux kernel. Although Patchwork has been developed with the kernel workflow in mind, the aim is to be flexible enough to suit the majority of community projects. -Download --------- - -The latest version of Patchwork is available with git. To download: - -.. code-block:: shell - - $ git clone git://github.com/getpatchwork/patchwork - -Patchwork is distributed under the `GNU General Public License (v2)`__. - -__ http://www.gnu.org/licenses/gpl-2.0.html - -Design ------- - -Patchwork should supplement mailing lists, not replace them -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Patchwork isn't intended to replace a community mailing list; that's why you -can't comment on a patch in Patchwork. If this were the case, then there would -be two forums of discussion on patches, which fragments the patch review -process. Developers who don't use Patchwork would get left out of the -discussion. - -However, a future development item for Patchwork is to facilitate on-list -commenting, by providing a "send a reply to the list" feature for logged-in -users. +.. _user-docs: -Don't pollute the project's changelogs with Patchwork poop -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -A project's changelogs are valuable - we don't want to add Patchwork-specific -metadata. - -Patchwork users shouldn't require a specific version control system -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Not everyone uses git for kernel development, and not everyone uses git for -Patchwork-tracked projects. - -It's still possible to hook other programs into Patchwork, using the pwclient -command-line client for Patchwork, or directly to the XML RPC interface. - -Getting Started ---------------- - -You should check out the `deployment/installation` and -`development/installation` guides for information on how to configure -Patchwork for production and development environments, respectively. - -Support -------- - -All questions and contributions should be sent to the -`Patchwork mailing list`__ - -__ https://ozlabs.org/mailman/listinfo/patchwork +.. toctree:: + :maxdepth: 2 + :caption: User Documentation + + usage/overview + usage/design + usage/delegation + usage/headers + usage/rest + usage/xmlrpc |