[PATCH 1/2] docs: Add references to VSCode Patchwork plugin
stephen at that.guru
Sat Sep 10 00:29:42 AEST 2022
Signed-off-by: Stephen Finucane <stephen at that.guru>
Cc: Florent Revest <revest at chromium.org>
README.rst | 20 ++++++++++++++++++++
docs/usage/clients.rst | 32 +++++++++++++++++++++++++++-----
2 files changed, 47 insertions(+), 5 deletions(-)
diff --git README.rst README.rst
index 94ae431d..979801fb 100644
@@ -38,6 +38,26 @@ 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.
+Patchwork provides a web UI, a REST API, and a XML-RPC API (*deprecated*). You
+can use the APIs to `build you own application`__ or you can use one the many
+There are many existing Patchwork instances. Unless you're a larger project
+that is already hosting many of its own resources, you may wish to request a
+project on one of these instances.
diff --git docs/usage/clients.rst docs/usage/clients.rst
index 01dd62a2..47ddb3a1 100644
@@ -4,6 +4,13 @@ Clients
A number of clients are available for interacting with Patchwork's various
+ Got a client that you think might be useful to the broader community? Feel
+ free to add it to this page by `submitting a patch`__.
+ __ https://patchwork.readthedocs.io/en/latest/development/contributing/
@@ -31,7 +38,7 @@ __ https://github.com/getpatchwork/pwclient/
-The :program:`git-pw` application can be used to integrate Git with Patchwork.
+The :program:`git-pw` application can be used to integrate Patchwork with Git.
The :program:`git-pw` application relies on the REST API and can be used to
interact to list, download and apply series, bundles and individual patches.
@@ -42,13 +49,28 @@ __ https://git-pw.readthedocs.io/
+The *Patchwork* VSCode plugin can be used to integrate Patchwork with VSCode.
+This plugin relies on the REST API and can be used to view both patches and
+series and to apply them locally. You can also browse patches and series and
+look at replies.
+More information on the *Patchwork* VSCode plugin can be found on the `VSCode
+Marketplace`__ and the `GitHub repo`__.
-The :program:`snowpatch` application is a bridge between Patchwork and the
-Jenkins continuous integration automation server. It monitors the REST API
-for incoming patches, applies them on top of an existing git tree, triggers
-appropriate builds and test suites, and reports the results back to Patchwork.
+The *snowpatch* application is a bridge between Patchwork and the Jenkins
+continuous integration automation server. It monitors the REST API for incoming
+patches, applies them on top of an existing git tree, triggers appropriate
+builds and test suites, and reports the results back to Patchwork.
Find out more about :program:`snowpatch` at its `GitHub repo`__.
More information about the Patchwork