Skip to content
Documentation

Disfavor another unimplemented deprecation (#123) #82

Sign in to view logs

Disfavor another unimplemented deprecation (#123)

Disfavor another unimplemented deprecation (#123) #82

Workflow file for this run

.github/workflows/documentation.yml at 75f739f
# Build and deploy DocC to GitHub pages. Based off of @karwa's work here:
# https://github.com/karwa/swift-url/blob/main/.github/workflows/docs.yml
name: Documentation
on:
release:
types:
- published
push:
branches:
- main
workflow_dispatch:
concurrency:
group: docs-${{ github.ref }}
cancel-in-progress: true
jobs:
build:
runs-on: macos-12
steps:
- name: Select Xcode 14.1
run: sudo xcode-select -s /Applications/Xcode_14.1.app
- name: Checkout Package
uses: actions/checkout@v3
with:
fetch-depth: 0
- name: Checkout gh-pages Branch
uses: actions/checkout@v3
with:
ref: gh-pages
path: docs-out
- name: Build documentation
run: >
rm -rf docs-out/.git;
rm -rf docs-out/main;
git tag -l --sort=-v:refname | grep -e "\d\+\.\d\+.0" | tail -n +6 | xargs -I {} rm -rf {};
for tag in $(echo "main"; git tag -l --sort=-v:refname | grep -e "\d\+\.\d\+.0" | head -6);
do
if [ -d "docs-out/$tag/data/documentation/xctestdynamicoverlay" ]
then
echo "✅ Documentation for "$tag" already exists.";
else
echo "⏳ Generating documentation for XCTestDynamicOverlay @ "$tag" release.";
rm -rf "docs-out/$tag";
git checkout .;
git checkout "$tag";
swift package \
--allow-writing-to-directory docs-out/"$tag" \
generate-documentation \
--target XCTestDynamicOverlay \
--output-path docs-out/"$tag" \
--transform-for-static-hosting \
--hosting-base-path /xctest-dynamic-overlay/"$tag" \
&& echo "✅ Documentation generated for XCTestDynamicOverlay @ "$tag" release." \
|| echo "⚠️ Documentation skipped for XCTestDynamicOverlay @ "$tag".";
fi;
done
- name: Fix permissions
run: 'sudo chown -R $USER docs-out'
- name: Publish documentation to GitHub Pages
uses: JamesIves/[email protected]
with:
branch: gh-pages
folder: docs-out
single-commit: true