Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Docs fix/add introductory paragraphs to subsections#4389

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 ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged
Bibo-Joshi merged 27 commits intopython-telegram-bot:masterfrommohdyusuf2312:docs-fix/add-introductory-paragraphs-to-subsections
Jul 24, 2024
Merged

Docs fix/add introductory paragraphs to subsections#4389

Bibo-Joshi merged 27 commits intopython-telegram-bot:masterfrommohdyusuf2312:docs-fix/add-introductory-paragraphs-to-subsections
Jul 24, 2024

Conversation

mohdyusuf2312
Copy link
Contributor

Description

This pull request adds introductory paragraphs to several sections in the PTB documentation and updates the "More info on xy" links to point to the PTB docs where appropriate.

Changes Made

  • Added introductory paragraphs to the Payments, Passport, Games, Inline Mode, Stickers, and Available Types sections.
  • Updated "More info on xy" links to point to relevant sections in the PTB docs.
  • Added my name to theAUTHORS.rst file.

Issue Addressed

docs/fix#4380

Available Types section before

image

Available Types section after

image

Stickers section before

image

Stickers section after

image

Inline Mode section before

image

Inline Mode section after

image

Payment section before

image

Payment section after

image

Games section before

image

Games section after

image

Passport section before

image

Passport section after

image

Additional Information

Please review the changes and let me know if any further adjustments are needed.

shujaurrahman reacted with hooray emoji
@Poolitzer
Copy link
Member

Hello, thanks for the PR.

Please dont modify the gitignore. The available types change is not needed, neither do we provide json objects nor does python have 32 bit signed integers.

For the rest without looking deeply into it: Please use for linking to ours the internal links as we do in the docs. So e.g. paramref:~telegram.Bot.local_mode for a parameter, :attr:telegram.Message.reply_markup for an attribute, :meth:telegram.Bot.set_game_score for a method, etc.

@mohdyusuf2312
Copy link
ContributorAuthor

image

I'm trying to apply internal linking, but it is not clickable. Can you please suggest how I can resolve this?

@Bibo-Joshi
Copy link
Member

Hi. the linking is case sensitive, i.e.:class:`telegram.Game` can work, but:class:`Telegram.Game` can not. If you want to link to a headline, it should be possible to use the headline as lower case and "-" instead of " " as target - e.g.:ref:`inline-mode` for a headline "Inline Mode". I'm not 100% sure on this one though.
Additionally, when you build the documentation in the command line, you will see warnings and errors being printed for references that could not be resolved.
If you're new to documentation python code with Sphinx, please also have a look at theirdocumentation, especiall at therst primer and thereferencing syntax.

@mohdyusuf2312
Copy link
ContributorAuthor

If you're new to documentation python code with Sphinx, please also have a look at theirdocumentation, especiall at therst primer and thereferencing syntax.
Thanks@Bibo-Joshi Sir

Copy link
Member

@Bibo-JoshiBibo-Joshi left a comment

Choose a reason for hiding this comment

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

Thanks for the updates. I left a few comments. In addition, what's still missing is making the "more about" links ponit to the PTB docs rather than TG docs as explained in#4380, e.g.

`More about games >> <https://core.telegram.org/bots/api#games>`_.

@mohdyusuf2312
Copy link
ContributorAuthor

Hello, is everything done, or should I do anything else?

Copy link
Member

@Bibo-JoshiBibo-Joshi left a comment

Choose a reason for hiding this comment

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

Added two small fixes that are not you're fault (seetdlib/telegram-bot-api#617).
LGTM now. Thanks very much for the PR and your patience during the review process :)

@Bibo-JoshiBibo-Joshi merged commit8a205b1 intopython-telegram-bot:masterJul 24, 2024
25 checks passed
@mohdyusuf2312mohdyusuf2312 deleted the docs-fix/add-introductory-paragraphs-to-subsections branchJuly 25, 2024 06:01
@mohdyusuf2312
Copy link
ContributorAuthor

Thank you sir, I feel very happy to complete my first contribution to open source. :)

@github-actionsgithub-actionsbot locked and limited conversation to collaboratorsAug 2, 2024
Sign up for freeto subscribe to this conversation on GitHub. Already have an account?Sign in.
Reviewers

@Bibo-JoshiBibo-JoshiBibo-Joshi approved these changes

Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

[Docs] Include introductory pragraphs
3 participants
@mohdyusuf2312@Poolitzer@Bibo-Joshi

[8]ページ先頭

©2009-2025 Movatter.jp