Use Docc for document generation (#59)

* Remove docs

* Generate docs on CI

* Bump checkout action to v4

.github/workflows/docs.yml

@@ -0,0 +1,25 @@
+# https://github.com/actions/virtual-environments
+
+name: docs
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+env:
+  DEVELOPER_DIR: /Applications/Xcode_15.2.app
+
+jobs:
+  publish-docs:
+    name: Publish Documentation
+    runs-on: macos-13
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build docs
+        run: make docs
+      - name: Deploy
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs

.github/workflows/test.yml

@@ -14,7 +14,7 @@ jobs:
     name: Validation
     runs-on: macos-13
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Get SwiftPM cache
         uses: actions/cache@v2
@@ -42,7 +42,7 @@ jobs:
     name: Test on macOS
     runs-on: macos-13
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
       - name: Show environments
         run: |
           swift --version

.gitignore

@@ -27,7 +27,8 @@ node_modules
 .swiftpm
 .build
 
-## Visual regression test
+## Snapshot test
 Snapshots
-.reg
-gcloud-service-key.json
+
+## Documentation
+docs

Makefile

@@ -16,6 +16,13 @@ format:
 lint:
 	$(TOOL) swift-format lint -s -p -r Sources Tests
 
+.PHONY: docs
+docs:
+	xcodebuild docbuild \
+	  -scheme PlaybookUI \
+	  -destination generic/platform=iOS \
+	  OTHER_DOCC_FLAGS="--transform-for-static-hosting --hosting-base-path playbook-ios --output-dir docs"
+
 .PHONY: npm
 npm:
 	npm i