From d1c8ec9e489134a804834a049cd9f80794b48abb Mon Sep 17 00:00:00 2001
From: Stuart Mumford <stuart@cadair.com>
Date: Thu, 5 Jul 2018 21:18:28 -0600
Subject: [PATCH 1/5] add circle config

---
 .circleci/config.yml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 .circleci/config.yml

diff --git a/.circleci/config.yml b/.circleci/config.yml
new file mode 100644
index 000000000..e8df5956b
--- /dev/null
+++ b/.circleci/config.yml
@@ -0,0 +1,19 @@
+version: 2
+jobs:
+  build-docs:
+    docker:
+      - image: uhoreg/matrix-doc-build
+    steps:
+      - checkout
+      - run: python scripts/gendoc.py
+
+workflows:
+  version: 2
+
+  egg-info:
+    jobs:
+      - build-docs
+
+notify:
+  webhooks:
+    - url: https://giles.cadair.com/circleci

From 86b00451953d96e7af2eadb1c013415a488fc8c4 Mon Sep 17 00:00:00 2001
From: Stuart Mumford <stuart@cadair.com>
Date: Thu, 5 Jul 2018 21:25:15 -0600
Subject: [PATCH 2/5] virtualenvs are the worst

---
 .circleci/config.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index e8df5956b..c11e36bad 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -2,9 +2,10 @@ version: 2
 jobs:
   build-docs:
     docker:
-      - image: uhoreg/matrix-doc-build
+      - image: circleci/python:2.7
     steps:
       - checkout
+      - run: pip install -r scripts/requirements.txt
       - run: python scripts/gendoc.py
 
 workflows:

From fe43b79e73f84708ad7ae5b641f7a69be8020170 Mon Sep 17 00:00:00 2001
From: Stuart Mumford <stuart@cadair.com>
Date: Thu, 5 Jul 2018 21:29:12 -0600
Subject: [PATCH 3/5] what's even the point

---
 .circleci/config.yml | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index c11e36bad..236a1d813 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -1,12 +1,17 @@
+gendoc: &gendoc
+  name: Generate the docs
+  command: |
+    source /env/bin/activate
+    scripts/gendoc.py
+
 version: 2
 jobs:
   build-docs:
     docker:
-      - image: circleci/python:2.7
+      - image: uhoreg/matrix-doc-build
     steps:
       - checkout
-      - run: pip install -r scripts/requirements.txt
-      - run: python scripts/gendoc.py
+      - run: *gendoc
 
 workflows:
   version: 2

From b7c3a7402282eb1b9787d07158e27c93521dec9e Mon Sep 17 00:00:00 2001
From: Stuart Mumford <stuart@cadair.com>
Date: Thu, 5 Jul 2018 21:31:57 -0600
Subject: [PATCH 4/5] artifacts

---
 .circleci/config.yml | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 236a1d813..06696633b 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -12,6 +12,11 @@ jobs:
     steps:
       - checkout
       - run: *gendoc
+      - store_artifacts:
+          path: scripts/gen
+      - run:
+          name: "Doc build is available at:"
+          command: DOCS_URL="${CIRCLE_BUILD_URL}/artifacts/${CIRCLE_NODE_INDEX}/${CIRCLE_WORKING_DIRECTORY/#\~/$HOME}/scripts/gen/index.html"; echo $DOCS_URL
 
 workflows:
   version: 2

From be5232914a704808f74ac9a5f32b1591fc7988ff Mon Sep 17 00:00:00 2001
From: Stuart Mumford <stuart@cadair.com>
Date: Thu, 5 Jul 2018 21:39:45 -0600
Subject: [PATCH 5/5] Maybe a swagger

---
 .circleci/config.yml | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/.circleci/config.yml b/.circleci/config.yml
index 06696633b..c11eb70dc 100644
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -4,6 +4,12 @@ gendoc: &gendoc
     source /env/bin/activate
     scripts/gendoc.py
 
+gendoc: &genswagger
+  name: Generate the swagger
+  command: |
+    source /env/bin/activate
+    scripts/dump-swagger.py
+
 version: 2
 jobs:
   build-docs:
@@ -18,12 +24,25 @@ jobs:
           name: "Doc build is available at:"
           command: DOCS_URL="${CIRCLE_BUILD_URL}/artifacts/${CIRCLE_NODE_INDEX}/${CIRCLE_WORKING_DIRECTORY/#\~/$HOME}/scripts/gen/index.html"; echo $DOCS_URL
 
+  build-swagger:
+    docker:
+      - image: uhoreg/matrix-doc-build
+    steps:
+      - checkout
+      - run: *genswagger
+      - store_artifacts:
+          path: scripts/swagger/api-docs.json
+      - run:
+          name: "Swagger UI is available at:"
+          command: SWAGGER_URL="${CIRCLE_BUILD_URL}/artifacts/${CIRCLE_NODE_INDEX}/${CIRCLE_WORKING_DIRECTORY/#\~/$HOME}/scripts/swagger/api-docs.json"; echo "https://matrix.org/docs/api/client-server/?url="$SWAGGER_URL
+
 workflows:
   version: 2
 
-  egg-info:
+  build-spec:
     jobs:
       - build-docs
+      - build-swagger
 
 notify:
   webhooks: