aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorStephen Finucane <stephen.finucane@intel.com>2016-01-28 11:34:17 +0000
committerStephen Finucane <stephen.finucane@intel.com>2016-02-05 17:37:55 +0000
commit6caa8493bc6dfbfcb6e39fa6cc0fb531939bf7b5 (patch)
treed9ee9776a6821f4257c1644264d1d631bd43fc97
parent2bce1f35799675146a3a0ec2a9e98c049bed4830 (diff)
downloadpatchwork-6caa8493bc6dfbfcb6e39fa6cc0fb531939bf7b5.tar
patchwork-6caa8493bc6dfbfcb6e39fa6cc0fb531939bf7b5.tar.gz
docs: Add a README
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>
-rw-r--r--README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
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