-
-
Notifications
You must be signed in to change notification settings - Fork 40.4k
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
CI: Add docs build and deploy workflow #7448
Conversation
Thank you for your contribution! |
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.
Looks good to me.
e827885
to
4ab09b7
Compare
943c9f5
to
5b1f163
Compare
CI changes might have to wait, or change in scope due to https://github.uint.cloudmunity/t5/GitHub-Actions/Github-action-not-triggering-gh-pages-upon-push/td-p/26869/highlight/true still being unresolved for public repos. Or I need someone with additional permissions to create/configure a token. Edit: The above is now resolved as described within the above link. Should be good to go now. |
fd8a95a
to
f000163
Compare
Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com>
f000163
to
f44971c
Compare
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.
Lets go for another green tick.
* Add docs build and deploy workflow * Remove old travis docs workflow * update to cli command * Tidy up for review * formatting * Update to pass style checks * Update lib/python/qmk/cli/docs.py Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com> * Review comments - build->generate, use of verbose * Add docs * Update to match recent actions * Run within base_container * Convert cli to generate-docs * Convert cli to generate-docs - restore old file * Convert cli to generate-docs * Update docs Co-authored-by: skullydazed <skullydazed@users.noreply.github.com>
* Add docs build and deploy workflow * Remove old travis docs workflow * update to cli command * Tidy up for review * formatting * Update to pass style checks * Update lib/python/qmk/cli/docs.py Co-Authored-By: skullydazed <skullydazed@users.noreply.github.com> * Review comments - build->generate, use of verbose * Add docs * Update to match recent actions * Run within base_container * Convert cli to generate-docs * Convert cli to generate-docs - restore old file * Convert cli to generate-docs * Update docs Co-authored-by: skullydazed <skullydazed@users.noreply.github.com>
Description
It sounds like we are kinda settled on a static generator for docs pages, but not which one to use.
So to set the process going, this PR gets the docs hooked up to a gh-pages branch, and pulls out the internal docs generation from the travis workflow. Short term, this helps us migrate CI, but longer term, we largely only have to slot in a different build command at a later date.
An example output is available at https://github.com/zvecr/qmk_firmware/tree/gh-pages
Types of Changes
Checklist