use xcodebuild docbuild command instead of swift-docc-plugin

Author: lukepistrol

.github/scripts/build-docc.sh

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+export LC_CTYPE=en_US.UTF-8
+
+set -o pipefail && xcodebuild clean docbuild -scheme CodeEditKit \
+    -destination generic/platform=macos \
+    OTHER_DOCC_FLAGS="--transform-for-static-hosting --hosting-base-path CodeEditKit --output-path ./docs" | xcpretty

.github/workflows/build-documentation.yml

@@ -11,13 +11,8 @@ jobs:
     steps:
       - name: Checkout repository
         uses: actions/checkout@v1
-      - uses: fwcd/swift-docc-action@v1.0.2
-        with:
-          target: CodeEditKit
-          output: ./docs
-          hosting-base-path: CodeEditKit
-          disable-indexing: 'true'
-          transform-for-static-hosting: 'true'
+      - name: Build Documentation
+        run: exec ./.github/scripts/build-docc.sh
       - name: Init new repo in dist folder and commit generated files
         run: |
           cd docs
@@ -34,3 +29,29 @@ jobs:
           branch: docs
           force: true
           directory: ./docs
+
+      ############################
+      ##### IMPORTANT NOTICE #####
+      ############################
+      # This was used to build the documentation catalog until
+      # it didn't produce the 'documentation' directory anymore.
+      #
+      # - uses: fwcd/swift-docc-action@v1.0.2
+      #   with:
+      #     target: CodeEditKit
+      #     output: ./docs
+      #     hosting-base-path: CodeEditKit
+      #     disable-indexing: 'true'
+      #     transform-for-static-hosting: 'true'
+      #
+      # The command that this plugin uses is:
+      #
+      # swift package --allow-writing-to-directory ./docs generate-documentation \
+      #       --target CodeEditKit
+      #       --output-path ./docs 
+      #       --hosting-base-path CodeEditKit
+      #       --disable-indexing 
+      #       --transform-for-static-hosting
+      #
+      # We now use xcodebuild to build the documentation catalog instead.
+      #