New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Update DocC setup instructions #511
Conversation
08c6d34
to
171e8db
Compare
171e8db
to
06f1439
Compare
README.md
Outdated
@@ -87,7 +87,7 @@ project's technical documentation: | |||
with support for building and viewing documentation for your framework and | |||
its dependencies. | |||
|
|||
## Getting Started with `docc` | |||
## Getting Started with developing `docc` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
very minor; the rest of the headers use sentence case
## Getting Started with developing `docc` | |
## Getting started with developing `docc` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Good catch, thank you!
README.md
Outdated
to get started with [building](https://apple.github.io/swift-docc-plugin/documentation/swiftdoccplugin/generating-documentation-for-a-specific-target), [previewing](https://apple.github.io/swift-docc-plugin/documentation/swiftdoccplugin/previewing-documentation), | ||
and publishing your documentation to your [website](https://apple.github.io/swift-docc-plugin/documentation/swiftdoccplugin/generating-documentation-for-hosting-online) or [GitHub Pages](https://apple.github.io/swift-docc-plugin/documentation/swiftdoccplugin/publishing-to-github-pages). | ||
|
||
### Assembling symbol graphs and building with `docc` directly |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not sure any of this belongs in the README at this point. Maybe we should move it to the CONTRIBUTING if it's not already there?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
that's a good point. it's more of an advanced use case. I've moved it
b2409b3
to
9354f58
Compare
Updates the instructions to get started with DocC to mention that using the Swift-DocC plugin is the preferred way of using DocC.
9354f58
to
a5bd84e
Compare
@swift-ci please test |
Bug/issue #, if applicable: N/A
Summary
Updates the instructions to get started with DocC to mention that using the Swift-DocC plugin is the preferred way of using DocC.
Dependencies
None.
Testing
N/A
Checklist
[ ] Added testsN/A./bin/test
script and it succeeded