lukasschwab / arxiv.py

Python wrapper for the arXiv API

MIT License

1.11k stars 123 forks source link

Make `pdoc`-generated docs more comprehensive #70

Closed lukasschwab closed 3 years ago

lukasschwab commented 3 years ago

Description

Include README.md as preamble with ReST directive.
Add missing docstrings, e.g. for constructors.
Reformat docstrings to more closely resemble Google's Python Style Guide.
- Separate short initial descriptions from detailed descriptions/hints with blank lines.
- Skip breaking out parameter descriptions for the time being: probably want to stick to ReST rather than Google style here.

Describing parameters and return values in docstrings will be a good future improvement.

Breaking changes

List any changes that break the API usage supported on master.

None: only updates docs.

Relevant issues

List GitHub issues relevant to this change.

N/A

Checklist

[ ] ~(If appropriate) README.md example usage has been updated.~