Skip to content
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

Create documentation with write-the #17

Merged
merged 2 commits into from Apr 17, 2023
Merged

Conversation

Wytamma
Copy link
Contributor

@Wytamma Wytamma commented Apr 17, 2023

Hi @eimenhmdt,

Awesome project! I've also been working on a GPT-CLI write-the (https://github.com/wytamma/write-the). I used the commands write-the docs and write-the mkdocs to create documentation for autoresearcher.

You can see a demo version of the site here -> https://blog.wytamma.com/autoresearcher/

Screen Shot 2023-04-17 at 10 22 00 am

Screen Shot 2023-04-17 at 10 23 09 am

@eimenhmdt
Copy link
Owner

Hey @Wytamma! Wow, that's awesome. Love it. And it updates the documentation automatically, right?

@Wytamma
Copy link
Contributor Author

Wytamma commented Apr 17, 2023

@eimenhmdt yep it pulls the API reference from the docstrings so if you update the docstrings it'll recreate the docs. If the code structure changes or you add new functions etc you can regenerate the docs with write-the mkdocs autoresearcher and that'll pull any functions with docstrings into the reference.

To get the site to go live you'll just have change your pages settings and the action will take care of the rest i.e.
image

@eimenhmdt
Copy link
Owner

That sounds excellent. Thanks for this amazing contribution!!

@eimenhmdt eimenhmdt merged commit cf4822b into eimenhmdt:main Apr 17, 2023
@eimenhmdt
Copy link
Owner

Sorry, maybe a stupid question haha, but how do I get the page to look like the demo page you sent me? :D

https://eimenhmdt.github.io/autoresearcher/

@Wytamma
Copy link
Contributor Author

Wytamma commented Apr 17, 2023

Ah you need to setup GitHub-Pages to deploy from the gh-pages branch should be here -> https://github.com/eimenhmdt/autoresearcher/settings/pages
image

@eimenhmdt you can see docs on how to do this here -> https://docs.github.com/en/pages/getting-started-with-github-pages/configuring-a-publishing-source-for-your-github-pages-site

@eimenhmdt
Copy link
Owner

It worked! Thank you so much!!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants