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

Create sphinx documentation for Read the Docs #329

Merged
merged 49 commits into from
Nov 7, 2019
Merged

Conversation

pietermarsman
Copy link
Member

@pietermarsman pietermarsman commented Nov 3, 2019

Description

This replaces the old html file documentation by a sphinx source documentation that can be build to html, pdf and others.
I've also set up documentation on Read the Docs.

The documentation is based on earlier documentation files. I've tried to improve it the best I can. But there is a long way to go. This PR should make it easy to improve our documentation by including the source into the repo.

Fixes #171
Fixes #199
Fixes #118
Fixes #178

How Has This Been Tested?

I've added building and doctesting the documentation to the .travis-ci.yml so it is tested on every commit.

Checklist

  • I have added tests that prove my fix is effective or that my feature works
  • I have updated the README.md and other documentation, or I am sure that this is not necessary
  • I have added a consice human-readable description of the change to CHANGELOG.md
  • I have added docstrings to newly created methods and classes
  • I have optimized the code at least one time after creating the initial version

Copy link
Contributor

@igormp igormp left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looking great.

@pietermarsman
Copy link
Member Author

I need to get a working py27 install to test get this to work ...

@igormp
Copy link
Contributor

igormp commented Nov 7, 2019

I managed to get it working. Let me do a PR for that

igormp and others added 3 commits November 7, 2019 20:35
@pietermarsman pietermarsman merged commit bc034c8 into develop Nov 7, 2019
@pietermarsman pietermarsman deleted the documentation branch November 9, 2019 10:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
2 participants