From d22c3074b745a07474a7dc1e06dd58908994bf37 Mon Sep 17 00:00:00 2001 From: Dan Finn Date: Tue, 27 Jan 2026 11:31:37 -0500 Subject: [PATCH 1/2] clean up merge reaction --- .github/workflows/slack-merge-reaction.yml | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 .github/workflows/slack-merge-reaction.yml diff --git a/.github/workflows/slack-merge-reaction.yml b/.github/workflows/slack-merge-reaction.yml new file mode 100644 index 0000000..8c71d8b --- /dev/null +++ b/.github/workflows/slack-merge-reaction.yml @@ -0,0 +1,18 @@ +name: Add Slack Merge Reaction + +on: + pull_request: + types: [closed] + +jobs: + add-merge-reaction: + if: github.event.pull_request.merged == true + uses: digitalocean/docs-automation/.github/workflows/slack-merge-reaction.yml@main + with: + pr_url: ${{ github.event.pull_request.html_url }} + pr_number: ${{ github.event.pull_request.number }} + merged_by: ${{ github.event.pull_request.merged_by.login }} + merge_commit_sha: ${{ github.event.pull_request.merge_commit_sha }} + secrets: + SLACK_BOT_TOKEN: ${{ secrets.PDOCS_SLACK_BOT_TOKEN }} + SLACK_CHANNEL_ID: ${{ secrets.PDOCS_SLACK_CHANNEL_ID }} From e36561baf7bbd44100a621b76f9c2fd19ad8ebd7 Mon Sep 17 00:00:00 2001 From: Dan Finn Date: Wed, 28 Jan 2026 11:03:37 -0500 Subject: [PATCH 2/2] clean up branch --- styles/PDocs/ActionVerbs.yml | 29 +++++++++++++++++++++++++++++ styles/PDocs/InputVerbs.yml | 9 +++++++++ 2 files changed, 38 insertions(+) create mode 100644 styles/PDocs/ActionVerbs.yml create mode 100644 styles/PDocs/InputVerbs.yml diff --git a/styles/PDocs/ActionVerbs.yml b/styles/PDocs/ActionVerbs.yml new file mode 100644 index 0000000..d48cb6d --- /dev/null +++ b/styles/PDocs/ActionVerbs.yml @@ -0,0 +1,29 @@ +extends: substitution +message: "Use '%s' instead of '%s' for clarity and accessibility." +link: https://docs.digitalocean.com/style/digitalocean/language/verbs +ignorecase: true +level: error +action: + name: replace +swap: + # Prefer "enter" over "type" for text input fields and form values + # Based on Microsoft Manual of Style and accessibility best practices + # "Enter" is device-agnostic and works for keyboard, voice, paste, and other input methods + type (?:in|into) the (\w+) (field|box): enter in the $1 $2 + type your (\w+) (?:in|into) the (?:\w+ )?(field|box): enter your $1 in the $2 + type (?:the|a|an) (\w+) (?:in|into) the (?:\w+ )?(field|box): enter $1 in the $2 + type or (?:copy and )?paste: enter + + # Prefer "select" over "click" for UI interactions + # "Select" works with keyboard, mouse, touch, voice, and assistive technologies + click the (\*\*[^*]+\*\*) button: select the $1 button + click the (\*\*[^*]+\*\*) link: select the $1 link + click on the (\*\*[^*]+\*\*) button: select the $1 button + click on the (\*\*[^*]+\*\*) link: select the $1 link + click the (\w+(?:\s+\w+)?) button: select the $1 button + click the (\w+(?:\s+\w+)?) link: select the $1 link + click on the (\w+(?:\s+\w+)?) button: select the $1 button + click on the (\w+(?:\s+\w+)?) link: select the $1 link + click the (\w+(?:\s+\w+)?) checkbox: select the $1 checkbox + click on the (\w+(?:\s+\w+)?) checkbox: select the $1 checkbox + click to (\w+): select to $1 diff --git a/styles/PDocs/InputVerbs.yml b/styles/PDocs/InputVerbs.yml new file mode 100644 index 0000000..2d6f833 --- /dev/null +++ b/styles/PDocs/InputVerbs.yml @@ -0,0 +1,9 @@ +extends: existence +message: "For accessibility, use 'press' only for keyboard keys. Use 'select' for buttons: '%s'." +link: https://docs.digitalocean.com/style/digitalocean/language/verbs +ignorecase: true +level: error +tokens: + - 'press the \w+ button' + - 'press the button' + - 'press a button'