Skip to content

change readthedocs.yaml to mkdocs publishing#206

Merged
wm-wm-wm merged 40 commits into
developfrom
feature/RTH-switch-to-mkdocs
Jul 3, 2026
Merged

change readthedocs.yaml to mkdocs publishing#206
wm-wm-wm merged 40 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%31->32, 32–33, 34->35, 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.

@wm-wm-wm wm-wm-wm merged commit 248d772 into develop Jul 3, 2026
12 checks passed
@wm-wm-wm wm-wm-wm deleted the feature/RTH-switch-to-mkdocs branch July 3, 2026 12:28
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