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

Add repository rst files in the sphinx docs #34462

Merged
merged 2 commits into from
Apr 30, 2024

Conversation

farhan
Copy link
Contributor

@farhan farhan commented Apr 3, 2024

Ticket: #33950
Planning ticket: #33047

Details of Implementation:

repository_docs.py contains the code to:

  1. Fetch the list of all the .rst docs/files in the repository
  2. Copy all these .rst files into docs directory to make them linkable in the sphinx build process.
  3. Generate the index.rst files in the new created directories to link all the copied .rst files in the sphinx docs.

I have closed following PR's and terminated these previous implementations associated with this feature as these approaches have technical limitations to proceed. For example to refer the .rst files outside of root docs directory
as discussed here
#33997
#34405

Testing instructions

  1. Checkout the branch
  2. In lms-shell go to /edx-platform/docs
  3. Run make html command to generate docs
  4. Explore docs directory for the files generated in the build process
  5. Open docs/_build/html/index.html in browser to navigate the docs
  6. Docs will be listed on path edx-platform/docs/_build/html/references/docs/index.html
Screenshots

@farhan farhan force-pushed the farhan/add-rst-files-in-docs-2 branch from 45f044f to 508eedc Compare April 3, 2024 05:44
@farhan farhan closed this Apr 3, 2024
@farhan farhan reopened this Apr 3, 2024
@farhan farhan force-pushed the farhan/add-rst-files-in-docs-2 branch from 508eedc to 6a196b4 Compare April 4, 2024 03:49
@farhan farhan closed this Apr 4, 2024
@farhan farhan reopened this Apr 4, 2024
@farhan farhan marked this pull request as ready for review April 4, 2024 05:11
docs/repository_docs.py Outdated Show resolved Hide resolved
@farhan farhan force-pushed the farhan/add-rst-files-in-docs-2 branch from 6a196b4 to 6c4170b Compare April 26, 2024 07:57
@feanil feanil merged commit 9b25c54 into openedx:master Apr 30, 2024
66 checks passed
@edx-pipeline-bot
Copy link
Contributor

2U Release Notice: This PR has been deployed to the edX staging environment in preparation for a release to production.

@edx-pipeline-bot
Copy link
Contributor

2U Release Notice: This PR has been deployed to the edX production environment.

1 similar comment
@edx-pipeline-bot
Copy link
Contributor

2U Release Notice: This PR has been deployed to the edX production environment.

@edx-pipeline-bot
Copy link
Contributor

2U Release Notice: This PR has been deployed to the edX staging environment in preparation for a release to production.

@edx-pipeline-bot
Copy link
Contributor

2U Release Notice: This PR has been deployed to the edX production environment.

1 similar comment
@edx-pipeline-bot
Copy link
Contributor

2U Release Notice: This PR has been deployed to the edX production environment.

@farhan farhan deleted the farhan/add-rst-files-in-docs-2 branch May 2, 2024 11:29
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