]> git.ipfire.org Git - thirdparty/patchwork.git/commitdiff
docs: Add a README
authorStephen Finucane <stephen.finucane@intel.com>
Thu, 28 Jan 2016 11:34:17 +0000 (11:34 +0000)
committerStephen Finucane <stephen.finucane@intel.com>
Fri, 5 Feb 2016 17:37:55 +0000 (17:37 +0000)
This is mostly a copy/paste of 'index.md' with added badges. This will
be useful to provide an overview to people who stumble upon patchwork
on GitHub.

Signed-off-by: Stephen Finucane <stephen.finucane@intel.com>
README.md [new file with mode: 0644]

diff --git a/README.md b/README.md
new file mode 100644 (file)
index 0000000..87509ed
--- /dev/null
+++ b/README.md
@@ -0,0 +1,30 @@
+# patchwork
+
+[![Requirements Status][badge-req-img]][badge-req-ref]
+[![Docs Status][badge-doc-img]][badge-doc-ref]
+
+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
+interesting) stuff.
+
+Patches that have been sent to a mailing list are 'caught' by the system, and
+appear on a web page. Any comments posted that reference the patch are appended
+to the patch page too. The project's maintainer can then scan through the list
+of patches, marking each with a certain state, such as Accepted, Rejected or
+Under Review. Old patches can be sent to the archive or deleted.
+
+Currently, patchwork is being used for a number of open-source projects, mostly
+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.
+
+# Additional Information
+
+For further information, please refer to the [docs][docs].
+
+[docs]: https://patchwork.readthedocs.org/en/latest/
+[badge-doc-ref]: https://patchwork.readthedocs.org/en/latest/
+[badge-doc-img]: https://readthedocs.org/projects/patchwork/badge/?version=latest
+[badge-req-ref]: https://requires.io/github/getpatchwork/patchwork/requirements/?branch=master
+[badge-req-img]: https://requires.io/github/getpatchwork/patchwork/requirements.svg?branch=master