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

Minor doc improvements #130

Merged
merged 1 commit into from
Jan 21, 2023
Merged

Minor doc improvements #130

merged 1 commit into from
Jan 21, 2023

Conversation

andy-maier
Copy link
Contributor

@andy-maier andy-maier commented Jan 7, 2023

For details, see the commit message.

@coveralls
Copy link

coveralls commented Jan 7, 2023

Coverage Status

Coverage: 100.0%. Remained the same when pulling 9803e24 on andy/doc-fixes into 04476fe on master.

@KSchopmeyer
Copy link

Approved al the changes themselves, Obviously there is the issue of it failing tests. :)

@andy-maier
Copy link
Contributor Author

The linkcheck error was caused by this issue sphinx-doc/sphinx#11041 and I resolved it by removing the # anchor in the link.

Details:

* Simplified the Installation section by merging a subchapter into the
  Installation chapter.

* Corrected the set of tested OS environments to no longer contain CygWin.

* Removed the prerequisites packages setuptools, pip and wheel for installation,
  since pip does not have any requirements on setuptools or wheel.

* Removed the "Python namespace" section and moved the statement about
  describing only the external API to the begin of the "API Reference"
  section.

* Specified language 'en' for the docs building in conf.py, to eliminate
  a corresponding warning during docs building.

* Generalized the version 3.4 to 3 in the link to the Python 3 glossary.

* Added 'make doclinkcheck' to the GitHub Actions test workflow, and
  documented this make target in 'make help' and added it to 'make all'.

Signed-off-by: Andreas Maier <andreas.r.maier@gmx.de>
@andy-maier andy-maier enabled auto-merge (rebase) January 21, 2023 04:24
@andy-maier andy-maier merged commit d0ab268 into master Jan 21, 2023
@andy-maier andy-maier deleted the andy/doc-fixes branch January 21, 2023 05:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants