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

Where are the docs? #148

Open
BoxingLaunch opened this issue Jan 19, 2022 · 4 comments
Open

Where are the docs? #148

BoxingLaunch opened this issue Jan 19, 2022 · 4 comments

Comments

@BoxingLaunch
Copy link

Can you add a link to the documentation in the README and on the PyPi page please

@bgreen-litl
Copy link
Member

The README is the docs. It made sense at first to just provide simple examples as the documentation. The simple examples still work, but at this point there's enough details and nuance that there should be separate documentation, perhaps hosted at readthedocs. The README can then become more of an installation, development, quickstart document.

@ranggakd
Copy link

The README is the docs. It made sense at first to just provide simple examples as the documentation. The simple examples still work, but at this point there's enough details and nuance that there should be separate documentation, perhaps hosted at readthedocs. The README can then become more of an installation, development, quickstart document.

I would support readthedocs at this point.

@DeflateAwning
Copy link

An example of something that docs should cover is all the different types of "wait generator" functions. There's a few, and they all have their own kwargs that can be passed to them, so it would be great to store those in one place to keep track of them

@edgarrmondragon
Copy link
Contributor

The README is the docs. It made sense at first to just provide simple examples as the documentation. The simple examples still work, but at this point there's enough details and nuance that there should be separate documentation, perhaps hosted at readthedocs. The README can then become more of an installation, development, quickstart document.

@bgreen-litl do you have any preferences for docs tool (e.g. Sphinx vs Mkdocs). I think I can send a PR your way to at least set up local development with a few pages. Wdyt?

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

No branches or pull requests

5 participants