Skip to content

Commit

Permalink
API docs: repo switcher
Browse files Browse the repository at this point in the history
Motivation:

API docs should be cross-linked.

Modifications:

Cross-link them.

Result:

better API docs
  • Loading branch information
weissi committed Mar 31, 2019
1 parent 65d6f63 commit 8e59048
Showing 1 changed file with 13 additions and 1 deletion.
14 changes: 13 additions & 1 deletion scripts/generate_docs.sh
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ jazzy_args=(--clean
--github_url https://github.com/apple/swift-nio
--theme fullwidth
--xcodebuild-arguments -scheme,swift-nio-Package)
cat > "$module_switcher" <<EOF
cat > "$module_switcher" <<"EOF"
# SwiftNIO Docs
SwiftNIO contains multiple modules:
Expand All @@ -70,6 +70,18 @@ for module in "${modules[@]}"; do
echo " - [$module](../$module/index.html)" >> "$module_switcher"
done

cat >> "$module_switcher" <<"EOF"
---
For the API documentation of the other repositories in the SwiftNIO family check:
- [`swift-nio` API docs](https://apple.github.io/swift-nio/docs/current/NIO/index.html)
- [`swift-nio-ssl` API docs](https://apple.github.io/swift-nio-ssl/docs/current/NIOSSL/index.html)
- [`swift-nio-http2` API docs](https://apple.github.io/swift-nio-http2/docs/current/NIOHTTP2/index.html)
EOF

for module in "${modules[@]}"; do
args=("${jazzy_args[@]}" --output "$root_path/docs/$version/$module" --module "$module"
--module-version $version
Expand Down

0 comments on commit 8e59048

Please sign in to comment.