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

Differentiate user info & user hello help messages (Fixes #51) #74

Merged
merged 4 commits into from
Apr 1, 2024

Conversation

KimFarida
Copy link
Contributor

Description:

This PR updates the help text for the user info and user hello commands within the FasHandler class. The descriptions are now more accurate and clearly distinguish the information provided by each command:

user info: Returns detailed information about a Fedora user.
user hello: Returns a brief introduction of a Fedora user.
This improves the user experience by providing clearer guidance on how to use these commands.

Resolves: #51

Changes:

Modified help text for user info and user hello commands.
Screenshot 2024-03-25 at 02 09 01

KimFarida and others added 2 commits March 25, 2024 01:15
…esolves fedora-infra#51)

This commit updates the help text for the user info and user hello commands

within the FasHandler class. The descriptions are modified to accurately

reflect the information provided by each command:

user info: Returns detailed information about a Fedora user, including username, human name, pronouns, creation date, timezone, locale, and GPG key IDs.

user hello: Returns a brief introduction of a Fedora user, including username, human name, and pronouns (if available).

This clarifies the distinction between the commands and improves the user experience

when interacting with the bot.

Signed-off-by: [KimFarida] <[farimomoh@gmail.com]>
@gridhead
Copy link
Member

@ryanlerch could you please look into this? TIA.

Copy link
Member

@jeremycline jeremycline left a comment

Choose a reason for hiding this comment

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

I'm not a maintainer so I can't accept this, but I saw you asking for reviews.

The changes to the help text look correct to me. I had one note about line wrapping, but it's not a technical issue or anything.

fedora/fas.py Outdated
@@ -178,11 +178,11 @@ async def user_hello(self, evt: MessageEvent, username: str | None) -> None:
"""
await self._user_hello(evt, username)

@user.subcommand(name="info", help="Return brief information about a Fedora user.")
@user.subcommand(name="info", help="Return detailed information about a Fedora user, including username, human name, pronouns, creation date, timezone, locale, and GPG key IDs.")
Copy link
Member

Choose a reason for hiding this comment

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

I'm not sure if this repository enforces a line limit, but even if it doesn't it would be nice to break this up into multiple lines. You can split up text into multiple source code lines without inserting newlines by doing something like

@user.subcommand(
    name="info",
    help=(
        "Return detailed information about a Fedora user, including username,"
        "  human name, pronouns, creation date, timezone, locale, and GPG key IDs."
    ),
)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Oh? I thought didn't think too much too it. Thank you so much for reviewing, I will make the corrections now.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@jeremycline I just made the corrections, thank you again for taking your time to look at my PRs. I am grateful.

@ryanlerch ryanlerch merged commit 08dccbb into fedora-infra:main Apr 1, 2024
4 checks passed
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.

user info help is same as user hello help
4 participants