Skip to content

Create documentation with write-the#17

Merged
eimenhmdt merged 2 commits intoeimenhmdt:mainfrom
Wytamma:main
Apr 17, 2023
Merged

Create documentation with write-the#17
eimenhmdt merged 2 commits intoeimenhmdt:mainfrom
Wytamma:main

Conversation

@Wytamma
Copy link
Copy Markdown
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
Copy Markdown
Owner

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

@Wytamma
Copy link
Copy Markdown
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
Copy Markdown
Owner

That sounds excellent. Thanks for this amazing contribution!!

@eimenhmdt eimenhmdt merged commit cf4822b into eimenhmdt:main Apr 17, 2023
@eimenhmdt
Copy link
Copy Markdown
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
Copy Markdown
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
Copy Markdown
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.

2 participants