Publish documentation to GitHub Pages by ofek · Pull Request #1774 · mhammond/pywin32 (original) (raw)
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 andprivacy statement. We’ll occasionally send you account related emails.
Already on GitHub?Sign in to your account
Conversation3 Commits2 Checks0 Files changed
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.Learn more about bidirectional Unicode characters
[ Show hidden characters]({{ revealButtonHref }})
Sorry for the delay, but this is awesome, thanks so much! I'll deal with adding links and manually triggering the first publish as I find time over the next few weeks, but I can't see any reason not to merge this now.
I saw from the readme section that you need help untangling the docs, please what exactly? So I can help
I saw from the readme section that you need help untangling the docs, please what exactly?
The docs are a mess - the main problems are:
- Most docs are generated by an "autoduck" tool which targets htmlhelp. This requires obscure Windows SDKs, can't be run on CI, etc - the github "publish docs" flow can't even build the docs - the best it can do it decompile the htmlhelp file.
- There's no sane place to add new docs, and no support for things like markdown, and integrating with the autoduck docs.