Skip to content

Conversation

scottclowe
Copy link
Member

Improvements to API documentation, and README.

We need to write ``fn() -> pandas.DataFrame`` instead of
``fn() -> pd.DataFrame``.
In README.rst we need to use hard API links so they will be
rendered correctly on GitHub, but on readthedocs (or other builds
of the documentation) we want them to link to the current build
so the class has the same version as is currently being viewed.
Instead of recommending
    ~/Datasets/bioscan/bioscan-5m/
we now recommend
    ~/Datasets/bioscan/
This is because the dataset itself contains a bioscan5m directory,
so the full path to the files was
    ~/Datasets/bioscan/bioscan-5m/bioscan5m/...
The new suggestion avoids the duplicated path.
@scottclowe scottclowe added the documentation Improvements or additions to documentation label Mar 20, 2025
@scottclowe scottclowe merged commit a5a1456 into master Mar 20, 2025
5 checks passed
@scottclowe scottclowe deleted the doc_improvements branch March 20, 2025 05:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant