From ba50c8b98fcdc7cc18eb54253dcf18fda924373d Mon Sep 17 00:00:00 2001
From: Alessandro Desantis <desa.alessandro@gmail.com>
Date: Thu, 29 Aug 2019 16:22:27 +0200
Subject: [PATCH] Document contribution guidelines for API documentation

---
 api/README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/api/README.md b/api/README.md
index e9c0f332bc0..da8f49e9920 100644
--- a/api/README.md
+++ b/api/README.md
@@ -9,3 +9,17 @@ Run the API tests:
 ```bash
 bundle exec rspec
 ```
+
+## Documentation
+
+The API documentation is in the [openapi](https://github.com/solidusio/solidus/tree/master/api/openapi)
+directory. It follows the OpenAPI specification and it is hosted on
+[Stoplight](https://solidus.docs.stoplight.io/).
+
+If you want to contribute, you can use [Stoplight Studio](https://stoplight.io/p/studio),
+an OpenAPI editor, to edit the files visually, and copy-paste the 
+resulting code into the `openapi` directory.
+
+CircleCI automatically syncs our Git repo with Stoplight when a PR is
+merged, and automatically publishes a new version on Stoplight when
+a new Solidus version is released.