Prepeare Documentation for Release#3
Conversation
|
You can see the generated documentation on: |
There was a problem hiding this comment.
-
At the moment, we have only two
*.mdfiles:CHANGELOG.mdandCONTRIBUTING.md. Everything else is*.rst. Should we move completely to*.rst? -
Is
usage.rstup to date? -
Autogenerated package documentation looks a bit messy. We should think about better structure. One option is to create this structure manually, (Example: https://github.com/requests/requests/blob/master/docs/api.rst)
-
We can use this link as a guide for the next steps
https://realpython.com/documenting-python-code/
e45bce7 to
d70bdd4
Compare
|
@LD250 i think we are ready here. Can you have a look over it? |
|
I like the table of content and I think docs look good for launch. Please merge this one. I think we should consider moving to the docstrings at some point. In this way, documentation will be more maintainable and will be available on only on readthedocs but in the code base as well. I believe #13 will be the next step in documentation improvement. |
|
For me, #13 is a requirement for a version 1.0 release. People will look at our code and a total lack of in-code documentation won’t give them the feeling that our library is mature and high-quality. |
fd88c0b to
58e3c05
Compare
4316042 to
fb8c2d5
Compare
Add SSH Key Docs
Add Images Add Volumes
Use `False` instead of false Use `True` instead of true Remove Description from functions that are correctly named like "Deletes a server", there is no need for an additional description
Make _add_meta_to_result protected
Co-Authored-By: LKaemmerling <4281581+LKaemmerling@users.noreply.github.com>
Rename APIException Reference
Co-Authored-By: LKaemmerling <4281581+LKaemmerling@users.noreply.github.com>
Fix tests
a6e313c to
5e1419b
Compare
We need to prepare the documentation for the release.
This PR polish the readme of the repo and the documentation on read the docs (rtd).
First of all we should specify the scope of the readme as "for hcloud-python developers".
The docs on rtd is for users of the hcloud-python module, so we should start with some easy examples and a basic introduction. Then we should list all steps needed for the installation.
I also removed the authors.md, because we didn't have it elsewhere in our repositories.
This is just a first draft of how we could polish the documentation. What do you think about this?