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

docs: add slack username helptext #5259

Merged
merged 5 commits into from
Oct 28, 2024
Merged

Conversation

R-HNF
Copy link
Contributor

@R-HNF R-HNF commented Oct 27, 2024

⚠️⚠️⚠️ Since we do not accept all types of pull requests and do not want to waste your time. Please be sure that you have read pull request rules:
https://github.com/louislam/uptime-kuma/blob/master/CONTRIBUTING.md#can-i-create-a-pull-request-for-uptime-kuma

Tick the checkbox if you understand [x]:

  • I have read and understand the pull request rules.

Description

Add help text about how to use the slack Username and the difference from mentions.

Fixes #4560

Type of change

Please delete any options that are not relevant.

  • User interface (UI)

Checklist

  • My code follows the style guidelines of this project
  • I ran ESLint and other linters for modified files
  • I have performed a self-review of my own code and tested it
  • I have commented my code, particularly in hard-to-understand areas (including JSDoc for methods)
  • My changes generates no new warnings
  • My code needed automated testing. I have added them (this is optional task)

Screenshots (if any)

Please do not use any external image service. Instead, just paste in or drag and drop the image here, and it will be uploaded automatically.

スクリーンショット 2024-10-28 9 55 45

My slack test message:
image

@R-HNF R-HNF marked this pull request as ready for review October 27, 2024 09:54
Copy link
Collaborator

@CommanderStorm CommanderStorm left a comment

Choose a reason for hiding this comment

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

What do you think about rewording it like this?

@@ -20,6 +20,9 @@
<i18n-t tag="p" keypath="aboutWebhooks" style="margin-top: 8px;">
<a href="https://api.slack.com/messaging/webhooks" target="_blank">https://api.slack.com/messaging/webhooks</a>
</i18n-t>
<p style="margin-top: 8px;">
{{ $t("aboutUsername", [$t("slack"), $t("Username"), $t("Friendly Name")]) }}
Copy link
Collaborator

Choose a reason for hiding this comment

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

I know that in other translations (in this file) this is done, but I don't like this pulling things out unless that makes translation simpler.

=> let's inline this one

Suggested change
{{ $t("aboutUsername", [$t("slack"), $t("Username"), $t("Friendly Name")]) }}
{{ $t("aboutSlackUsername") }}

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Indeed, it seems easier to manage.

(Also, when viewed in Japanese, it feels somewhat difficult to read since only parts are translated.)

src/lang/en.json Outdated
@@ -731,6 +731,7 @@
"Icon Emoji": "Icon Emoji",
"signalImportant": "IMPORTANT: You cannot mix groups and numbers in recipients!",
"aboutWebhooks": "More info about Webhooks on: {0}",
"aboutUsername": "The {0} {1} can change the display name of the message sender. This is not for mentions. If you want to mention someone, include it in the {2}.",
Copy link
Collaborator

Choose a reason for hiding this comment

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

lets reword it like this, what do you think?

Suggested change
"aboutUsername": "The {0} {1} can change the display name of the message sender. This is not for mentions. If you want to mention someone, include it in the {2}.",
"aboutSlackUsername": "Changes the display name of the message sender. If you want to mention someone, include it in the friendly name instead.",

@@ -20,6 +20,9 @@
<i18n-t tag="p" keypath="aboutWebhooks" style="margin-top: 8px;">
<a href="https://api.slack.com/messaging/webhooks" target="_blank">https://api.slack.com/messaging/webhooks</a>
</i18n-t>
<p style="margin-top: 8px;">
{{ $t("aboutUsername", [$t("slack"), $t("Username"), $t("Friendly Name")]) }}
Copy link
Collaborator

Choose a reason for hiding this comment

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

also, lets move this up to where the username field is, so that it is not so out of place

@CommanderStorm CommanderStorm added the pr:please address review comments this PR needs a bit more work to be mergable label Oct 27, 2024
@R-HNF
Copy link
Contributor Author

R-HNF commented Oct 28, 2024

@CommanderStorm
Thank you for your comment! I addressed it in this commit 527d40b, also updated the screenshot in the PR description.

I feel that the help text has become clearer. Thank you!

Copy link
Collaborator

@CommanderStorm CommanderStorm 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 improvements to the docs ♥️

src/components/notifications/Slack.vue Outdated Show resolved Hide resolved
@CommanderStorm CommanderStorm changed the title Add slack username usage docs: add slack username usage Oct 28, 2024
@CommanderStorm CommanderStorm changed the title docs: add slack username usage docs: add slack username helptext Oct 28, 2024
@CommanderStorm CommanderStorm added this to the 2.0.0 milestone Oct 28, 2024
@CommanderStorm CommanderStorm merged commit e99fbf1 into louislam:master Oct 28, 2024
19 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
pr:please address review comments this PR needs a bit more work to be mergable
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Using slack Username is missing the necessary helptext to explain what it does
2 participants