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

Initial setup for RTD Integration #206

Merged
merged 6 commits into from
Jan 5, 2024
Merged

Conversation

agileshaw
Copy link
Contributor

@agileshaw agileshaw commented Jan 5, 2024

Set up documentation integration with RTD using sphinx-docs-starter-pack following the instruction described in sphinx-docs-starter-pack repository (notable references: section documentation-in-a-code-repository and configure-the-documentation)

Set up documentation integration with RTD using sphinx-docs-starter-pack
following the instruction: https://github.com/canonical/sphinx-docs-starter-pack#documentation-in-a-code-repository
@agileshaw agileshaw requested a review from a team as a code owner January 5, 2024 14:54
Copy link

@pmatulis pmatulis left a comment

Choose a reason for hiding this comment

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

Configuration required

docs/custom_conf.py Outdated Show resolved Hide resolved
docs/custom_conf.py Outdated Show resolved Hide resolved
docs/custom_conf.py Show resolved Hide resolved
docs/custom_conf.py Show resolved Hide resolved
docs/custom_conf.py Outdated Show resolved Hide resolved
docs/custom_conf.py Outdated Show resolved Hide resolved
docs/custom_conf.py Outdated Show resolved Hide resolved
@agileshaw agileshaw marked this pull request as draft January 5, 2024 17:55
@agileshaw agileshaw marked this pull request as ready for review January 5, 2024 18:04
@agileshaw
Copy link
Contributor Author

@pmatulis I've updated the configuration as requested (I missed that section in README). May I ask for your review again?

@pmatulis
Copy link

pmatulis commented Jan 5, 2024

@agileshaw all good 🥇

Copy link
Contributor

@aieri aieri left a comment

Choose a reason for hiding this comment

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

Overall +1, just a couple of notes:

  • since this is the initial setup and does not contain the actual documentation wouldn't it be better to merge into an integration branch and keep master clean?
  • I know I asked to not exclude /docs/ from codespell, but now I have read that the documentation is already checked via aspell, so perhaps it's cleaner if we only rely on one spell checker

@agileshaw
Copy link
Contributor Author

@aieri I think it would be better to push the change directly to main because there are more setup on RTD side that @pmatulis will help us with and it can only be done once the docs directory is available.

As for the code spell, I agree and have just updated it.

Copy link
Contributor

@rgildein rgildein left a comment

Choose a reason for hiding this comment

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

I think it's ok.

.github/workflows/automatic-doc-checks.yml Show resolved Hide resolved
docs/.gitignore Show resolved Hide resolved
@agileshaw agileshaw merged commit ba628b3 into canonical:main Jan 5, 2024
4 checks passed
@agileshaw agileshaw deleted the add-docs branch January 5, 2024 23:06
@agileshaw agileshaw self-assigned this Jan 6, 2024
gabrielcocenza pushed a commit to gabrielcocenza/charmed-openstack-upgrader-1 that referenced this pull request Jan 11, 2024
* Initial setup for RTD Integration

Set up documentation integration with RTD using sphinx-docs-starter-pack following the instruction described in [sphinx-docs-starter-pack](https://github.com/canonical/sphinx-docs-starter-pack) repository (notable references: section [documentation-in-a-code-repository](https://github.com/canonical/sphinx-docs-starter-pack?tab=readme-ov-file#documentation-in-a-code-repository) and [configure-the-documentation](https://github.com/canonical/sphinx-docs-starter-pack?tab=readme-ov-file#configure-the-documentation))
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.

4 participants