Skip to content

change readthedocs.yaml to mkdocs publishing#206

Open
wm-wm-wm wants to merge 39 commits into
developfrom
feature/RTH-switch-to-mkdocs
Open

change readthedocs.yaml to mkdocs publishing#206
wm-wm-wm wants to merge 39 commits into
developfrom
feature/RTH-switch-to-mkdocs

Conversation

@wm-wm-wm

Copy link
Copy Markdown
Contributor

Change Summary

Modify the readthedocs.yaml to change the documentation build from sphinx to mkdocs

Related issue number

[DOP-37885]

Checklist

  • Commit message and PR title is comprehensive
  • Keep the change as small as possible
  • Unit and integration tests for the changes exist
  • Tests pass on CI and coverage does not decrease
  • Documentation reflects the changes where applicable
  • docs/changelog/next_release/<pull request or issue id>.<change type>.rst file added describing change
    (see CONTRIBUTING.rst for details.)
  • My PR is ready to review.

@wm-wm-wm wm-wm-wm requested a review from dolfinus June 24, 2026 12:11
@github-actions

github-actions Bot commented Jun 24, 2026

Copy link
Copy Markdown

Coverage

Coverage Report •
FileStmtsMissBranchBrPartCoverMissing
horizon/backend/settings/server
   static_files.py1444271%32–33, 35–36
TOTAL25282023088392% 

wm-wm-wm and others added 23 commits June 24, 2026 15:16
Comment thread .readthedocs.yaml
@dolfinus

dolfinus commented Jun 25, 2026

Copy link
Copy Markdown
Member

We should also update:

  • towncrier configs
  • changelog check in CI
  • Makefile jobs for building documentation (sphinx -> mkdocs, new docs location)
  • CONTRIBUTING.rst (probably should be renamed to .md and used as a snippet)
  • drop docs dependency group from pyproject.toml

See MTSWebServices/onetl@d708d99

@dolfinus

Copy link
Copy Markdown
Member

Please merge commits from develop branch to resolve uv.lock conflicts

@dolfinus dolfinus added the ci:skip-changelog Add this label to skip changelog file check label Jun 29, 2026
@dolfinus

Copy link
Copy Markdown
Member

There are 3 .rst files left in the repo:

  • README.rst
  • SECURITY.rst
  • CONTRIBUTING.rst

They should probably be replaced with .md files as well. Also I don't see why we need Security and Contributing sections in mddocs - these files are developer-only, it's enough to store them just in the repo root.

This can be changed in another PR.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ci:skip-changelog Add this label to skip changelog file check

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants