Start using docc plugin (#1463)

* wip

* wip

* syntax fix

* wip

* wip

Co-authored-by: Stephen Celis <[email protected]>
(cherry picked from commit 2c40fe0969a65c734759edb534d5f6e67c1379b2)

# Conflicts:
#	.github/workflows/documentation.yml

Author: mbrandonw

.github/workflows/documentation.yml

@@ -21,36 +21,6 @@ jobs:
         with:
           fetch-depth: 0
 
-      - name: Checkout swift-docc
-        uses: actions/checkout@v2
-        with:
-          repository: apple/swift-docc
-          ref: main
-          path: swift-docc
-
-      - name: Cache DocC
-        id: cache-docc
-        uses: actions/cache@v2
-        with:
-          key: swift-url-docc-build
-          path: swift-docc/.build
-
-      - name: Build swift-docc
-        if: ${{ !steps.cache-docc.outputs.cache-hit }}
-        run: |
-          cd swift-docc; swift build --product docc -c release; cd ..
-
-      - name: Checkout swift-docc-render
-        uses: actions/checkout@v2
-        with:
-          repository: apple/swift-docc-render
-          ref: main
-          path: swift-docc-render
-
-      - name: Build swift-docc-render
-        run: |
-          cd swift-docc-render; npm install && npm run build; cd ..
-
       - name: Checkout gh-pages Branch
         uses: actions/checkout@v2
         with:
@@ -65,41 +35,25 @@ jobs:
 
           for tag in $(echo "main"; git tag -l --sort=-v:refname | grep -e "\d\+\.\d\+.0" | head -6);
           do
-            if [ -d "docs-out/$tag" ] 
+            if [ -d "docs-out/$tag/data/documentation/composablearchitecture" ] 
             then 
               echo "✅ Documentation for "$tag" already exists.";
             else 
-              echo "⏳ Generating documentation for "$target" @ "$tag" release.";
+              echo "⏳ Generating documentation for ComposableArchitecture @ "$tag" release.";
+              rm -rf "docs-out/$tag";
 
-              for target in ComposableArchitecture Dependencies;
-              do 
                 git checkout .;
                 git checkout "$tag";
-                mkdir -p Sources/"$target"/Documentation.docc;
-                export DOCC_HTML_DIR="$(pwd)/swift-docc-render/dist";
 
-                rm -rf .build/symbol-graphs;
-                mkdir -p .build/symbol-graphs;
-                swift build \
-                  --target "$target" \
-                  -Xswiftc \
-                  -emit-symbol-graph \
-                  -Xswiftc \
-                  -emit-symbol-graph-dir \
-                  -Xswiftc \
-                  .build/symbol-graphs \
-                  && swift-docc/.build/release/docc convert Sources/"$target"/Documentation.docc \
-                    --fallback-display-name "$target" \
-                    --fallback-bundle-identifier co.pointfree.ComposableArchitecture \
-                    --fallback-bundle-version 0.0.0 \
-                    --additional-symbol-graph-dir \
-                    .build/symbol-graphs \
+              swift package \
+                --allow-writing-to-directory docs-out/"$tag" \
+                generate-documentation \
+                --target ComposableArchitecture \
+                --output-path docs-out/"$tag" \
                     --transform-for-static-hosting \
                     --hosting-base-path /reactiveswift-composable-architecture/"$tag" \
-                    --output-path docs-out/"$tag" \
-                    && echo "✅ Documentation generated for "$target" @ "$tag" release." \
-                    || echo "⚠️ Documentation skipped for "$target" @ "$tag".";
-              done;
+                && echo "✅ Documentation generated for ComposableArchitecture @ "$tag" release." \
+                || echo "⚠️ Documentation skipped for ComposableArchitecture @ "$tag".";
             fi;
           done