refactor: move docs to this repository (#172)

.circleci/config.yml

@@ -1,30 +1,17 @@
 version: 2.1
 
 orbs:
-  sdk: ory/[email protected].23
+  sdk: ory/[email protected].31
   changelog: ory/[email protected]
   goreleaser: ory/[email protected]
   nancy: ory/[email protected]
+  docs: ory/[email protected]
+  golangci: ory/[email protected]
 
 jobs:
-  format:
-    docker:
-      - image: circleci/golang:1.13
-    working_directory: /go/src/github.com/ory/keto
-    steps:
-      - checkout
-      - run:
-          name: Enable go1.11 modules
-          command: |
-            echo 'export GO111MODULE=on' >> $BASH_ENV
-            source $BASH_ENV
-      - run: curl -sfL https://install.goreleaser.com/github.com/golangci/golangci-lint.sh | sh -s -- -b $(go env GOPATH)/bin latest
-      - run: go mod download
-      - run: golangci-lint run ./...
-
   test:
     docker:
-      - image: circleci/golang:1.13
+      - image: circleci/golang:1.14
         environment:
           - TEST_DATABASE_POSTGRESQL=postgres://test:test@localhost:5432/keto?sslmode=disable
           - TEST_DATABASE_MYSQL=root:test@(localhost:3306)/mysql?parseTime=true
@@ -53,20 +40,6 @@ jobs:
       # Submit coverage details
       - run: test -z "$CIRCLE_PR_NUMBER" && goveralls -service=circle-ci -coverprofile=coverage.txt -repotoken=$COVERALLS_REPO_TOKEN || echo "forks are not allowed to push to coveralls"
 
-  release-docs:
-    docker:
-      - image: circleci/golang:1.12 # if we use something else bash may be missing
-    working_directory: /go/src/github.com/ory/keto
-    steps:
-      - checkout
-      - run: ./scripts/run-configuration.sh
-      - run: git config --global user.email "[email protected]"
-      - run: git config --global user.name "ORY Continuous Integration"
-      - run: "git clone https://arekkas:[email protected]/ory/docs.git ../docs"
-      - run: "cp ./docs/api.swagger.json ../docs/apis/keto.json"
-      - run: "cp configuration.md ../docs/docs/keto/configuration.md"
-      - run: "(cd ../docs && git add -A && git commit -a -m \"Updates ORY Keto Swagger and config definitions\" && git push origin) || exit 0"
-
 workflows:
   version: 2
   "test, build, and relase":
@@ -75,22 +48,28 @@ workflows:
           filters:
             tags:
               only: /.*/
-      - format:
+      -
+        golangci/lint:
           filters:
             tags:
               only: /.*/
       - test:
           filters:
             tags:
               only: /.*/
-      - release-docs:
+      - changelog/generate:
+          requires:
+            - test
+            - golangci/lint
           filters:
+            tags:
+              only: /.*/
             branches:
               only: master
-      - changelog/generate:
+      - docs/build:
           requires:
             - test
-            - format
+            - golangci/lint
           filters:
             tags:
               only: /.*/
@@ -100,11 +79,11 @@ workflows:
           appname: Ory_Keto
           requires:
             - test
-            - format
+            - golangci/lint
       - sdk/release:
           requires:
             - test
-            - format
+            - golangci/lint
             - goreleaser/release
           filters:
             tags:
@@ -119,7 +98,7 @@ workflows:
           requires:
             - goreleaser/test
             - test
-            - format
+            - golangci/lint
           filters:
             tags:
               only: /.*/

.schema/README.md

@@ -0,0 +1,4 @@
+Please do not edit the `api.swagger.json` manually because it is autogenerated. Instead you need to update the
+swagger comments in the Go codebase.
+
+You may make modifications to the `config.schema.json` file.