Skip to content

#33 rtd documentation #59

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

Merged
merged 22 commits into from
Oct 8, 2021

Conversation

josh-silvas
Copy link
Contributor

Solves for #33 to produce RTD documentation on the diffsync library using the README files as a documentation source for details and examples, and using sphinx-apidoc for API reference doc generation.

I haven't created the RTD diffsync site on the github project just yet, but I can do that after we get everything lined out here. There is example documentation here https://diffsync-test.readthedocs.io/en/33-rtd-documentation/index.html

Copy link
Collaborator

@glennmatthews glennmatthews left a comment

Choose a reason for hiding this comment

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

This is a great start, thank you!

Getting Started
###############

.. mdinclude:: ../../../README.md
Copy link
Collaborator

Choose a reason for hiding this comment

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

Minor rendering error here as well - note that the last two paragraphs are indented as if they're part of the bulleted list:

image

Copy link
Contributor

@dgarros dgarros left a comment

Choose a reason for hiding this comment

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

I'm gonna merge this one, publish it and we'll fix rendering issue has we find them

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants