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

Documentation v0.3.0 #100

Open
enryH opened this issue Jul 2, 2020 · 4 comments
Open

Documentation v0.3.0 #100

enryH opened this issue Jul 2, 2020 · 4 comments

Comments

@enryH
Copy link
Collaborator

enryH commented Jul 2, 2020

  • Datenguide Python version: 0.3.0
  • Python version:
  • Operating System:

Description

Thread for comments on Documentation.

@enryH
Copy link
Collaborator Author

enryH commented Jul 2, 2020

image

Loading the README.rst leads to having the link to the documentation on top while one is on the documentation. Should we have a copy of the README just in the docs folder?

@enryH
Copy link
Collaborator Author

enryH commented Jul 2, 2020

Should we add a picture to the minimal example of the resulting DataFrame? Or even an embedded HTML version?

@enryH
Copy link
Collaborator Author

enryH commented Jul 2, 2020

there could be a button to launch the quick-start example or maybe some output added?

@KonradUdoHannes
Copy link
Collaborator

I have a little bit of output in the pitfall section which I'm working on. I first had a complete output example but that generates a table which his a little too large, due to the source default fields. Cutting of the source fields makes the tables small enough to display but would already make the example a little more than minimal.
I'm not sure what the best approach is, but maybe interactive examples would be better suited for binder. Currently Binder is not referenced in the documentation because we did not have it when the docs where setup.

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

2 participants