Skip to content

Add configuration file for Read the Docs#1478

Merged
mdickinson merged 4 commits into
masterfrom
docs/readthedocs-config
Jul 2, 2021
Merged

Add configuration file for Read the Docs#1478
mdickinson merged 4 commits into
masterfrom
docs/readthedocs-config

Conversation

@mdickinson
Copy link
Copy Markdown
Member

This PR adds a basic configuration file for Read the Docs. This file was sufficient to get the RtD build passing. See https://traits.readthedocs.io/en/docs-readthedocs-config/ for the documentation built from this branch.

@rahulporuri rahulporuri self-requested a review July 1, 2021 16:16
Copy link
Copy Markdown
Contributor

@rahulporuri rahulporuri left a comment

Choose a reason for hiding this comment

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

LGTM. The built docs on readthedocs look good to me.

Comment thread .readthedocs.yaml
Comment on lines +9 to +12
- method: pip
path: .
extra_requirements:
- docs
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

I guess this means python -m pip install .[docs]? It's not clear from the docs page.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Yep. I think there's an example in the RtD docs that makes this somewhat clear, but you're right that it doesn't seem to be spelled out explicitly.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

For reference, I was looking at the bit just after the text "With the previous settings, Read the Docs will execute the next commands:"

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.

2 participants