GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — Autogenerate .rst file generation by harshil21 · Pull Request #5323 · python-telegram-bot/python-telegram-bot

Conversation

@harshil21

@harshil21 harshil21 commented Aug 4, 2026

Copy link
Copy Markdown
Member

Closes #5309

There is now no longer a need to manually write out the .rst files! This PR also organizes the remaining .rst files into their respective categories, e.g. ext, or examples.

Docs for classes which used private bases like _BaseThumbedMedium have been changed temporarily to follow the same pattern as the normal telegram classes. This was done because #5279 will eliminate them and it makes this implementation easier if we don't have to account for it.

api_docs.py is where the logic lives, and was largely AI generated, but I did refine it over many prompts until my satisfaction for readability and maintainability.

TODO:

  • Autogen pages should not be checked into git, should probably go into a separate gitignored directory
  • Update roolsbot and other links to link to the new examples URL correctly. (Have the PR ready, merge just before v23 is released)
  • Merge only after the dataclasses implementation!

Sorry, something went wrong.

Uh oh!

There was an error while loading. Please reload this page.

All reactions
harshil21 added 4 commits July 26, 2026 21:34
@harshil21
Initial .rst autogeneration code
65624b0
@harshil21
Remove AI slop, organize .rst files into folders
041a0bc
@harshil21
Only use examples/, remove autogen files for examples in source/
08c768e
Also changes the path from the . to /
@harshil21
Remove invalid AI change
84a463d
@harshil21 harshil21 added the ⚙️ documentation affected functionality: documentation label Aug 4, 2026

This branch has not been deployed

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

Reviewers

No reviews

Uh oh!

There was an error while loading. Please reload this page.

Assignees

No one assigned

Labels

⚙️ documentation affected functionality: documentation

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

Uh oh!

There was an error while loading. Please reload this page.

1 participant

@harshil21
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
You are visitor 01402503 — GeezerVison does not store the pages you look up.
Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.