Enhance documentation with improved phrasing

hawkeyexl · hawkeyexl · commit 55a02d61ab04 · 2025-10-10T17:36:10.000-04:00
- Add exclamation marks for a more engaging tone in various sections.
- Update phrasing to improve clarity and readability.
diff --git a/docs/contribute/docs/index.mdx b/docs/contribute/docs/index.mdx
@@ -7,11 +7,11 @@ sidebar_position: 1
 
 # Contribute to the docs
 
-Welcome. Doc Detective is better because of contributors like you. Whether you're fixing a typo, adding an example, or writing comprehensive tutorials, your contribution matters.
+Welcome! Doc Detective is better because of contributors like you. Whether you're fixing a typo, adding an example, or writing comprehensive tutorials, your contribution matters.
 
 ## Good enough is better than perfect
 
-You don't need to be a technical writer or documentation expert to contribute. If you see something that could be clearer, more accurate, or more helpful, you can improve it. We value accurate information over elegant prose—if you know something that should be documented, share it.
+You don't need to be a technical writer or documentation expert to contribute. If you see something that could be clearer, more accurate, or more helpful, you can improve it. We value accurate information over elegant prose—if you know something that should be documented, share it!
 
 ## Before you start
 
@@ -83,7 +83,7 @@ If your PR doesn't get a response within our SLA, feel free to respectfully ping
 
 ## Recognition
 
-All contributors are acknowledged in our release notes and on our contributors page. Thank you for making Doc Detective better.
+All contributors are acknowledged in our release notes and on our contributors page. Thank you for making Doc Detective better!
 
 ## Other ways to contribute
 
diff --git a/docs/contribute/docs/review-process.mdx b/docs/contribute/docs/review-process.mdx
@@ -50,7 +50,7 @@ In your pull request, you'll see status checks:
 
 ### If checks fail
 
-Don't panic. Failed checks are common and can usually be fixed.
+Don't panic. Failed checks happen and can usually be fixed.
 
 #### Vale failures
 
@@ -279,7 +279,7 @@ Most disagreements resolve through discussion.
 
 ### When your PR is approved
 
-Congratulations. Your contribution will be merged soon.
+Congratulations! Your contribution will be merged soon.
 
 What happens next:
 
@@ -289,7 +289,7 @@ What happens next:
 
 ### After merge
 
-Celebrate. 🎉 You've contributed to open source. Post about it, add to your portfolio, tell your friends.
+Celebrate! 🎉 You've contributed to open source! Post about it, add to your portfolio, tell your friends.
 
 If your PR addresses an issue, it should close automatically.
 
@@ -369,7 +369,7 @@ Life happens. If you can't address feedback right away,
 - **Suggest improvements**: Open issues for documentation gaps you notice
 - **Join the community**: Engage in Discord discussions
 
-### You're now a contributor
+### You're now a contributor!
 
 Thank you for making Doc Detective better. Your contribution, no matter how small, helps all of our users.
 
diff --git a/docs/contribute/docs/templates/tutorial.mdx b/docs/contribute/docs/templates/tutorial.mdx
@@ -176,7 +176,7 @@ Tutorials should be encouraging:
 
 ✅ Good:
 
-> Great. You've created your first test. Let's make it more useful by adding another action.
+> Great! You've created your first test. Let's make it more useful by adding another action.
 
 ⛔ Too formal:
 
diff --git a/docs/get-started/installation.md b/docs/get-started/installation.md
@@ -53,7 +53,7 @@ Downloading and running Doc Detective is straightforward. Follow these steps to
    npx doc-detective --input sample.spec.json
    ```
 
-Congratulations. You've run your first test with Doc Detective.
+Congratulations! You've run your first test with Doc Detective.
 
 ## Next steps
 
diff --git a/docs/get-started/intro.md b/docs/get-started/intro.md
@@ -13,7 +13,7 @@ npx doc-detective
 
 Want to use the Docker image? [Check it out](https://github.com/doc-detective/docker-image).
 
-See the [Installation](/docs/get-started/installation.md) guide to get started. Come chat on [Discord](https://discord.gg/uAfSjVH7yr).
+See the [Installation](/docs/get-started/installation.md) guide to get started. Come chat on [Discord](https://discord.gg/uAfSjVH7yr)!
 
 ## What is Doc Detective?
 
diff --git a/docs/get-started/tutorials/set-up-your-test-environment.mdx b/docs/get-started/tutorials/set-up-your-test-environment.mdx
@@ -19,7 +19,7 @@ You can use Doc Detective directly against your production site. For testing, it
    Replace `<path-to-expanded-test-examples>` with the actual path where you expanded the `TestExamples.zip` file.
 1. Install and run a webserver. Running your tests against a local server allows you to make edits and see them in real time. Also, you need to serve the files in a web browser to experiment with video recording and other features.
 
-   Any web server will do, but here are a few options (unassociated with Doc Detective):
+   Any web server works, but here are a few options (unassociated with Doc Detective):
 
    <Tabs>
       <TabItem value='python' label='Python'>
diff --git a/styles/config/vocabularies/Docs/accept.txt b/styles/config/vocabularies/Docs/accept.txt
@@ -24,6 +24,8 @@ configPath
 contentPath
 contextId
 CTRL
+dragAndDrop
+draggable
 defaultCommand
 descriptionPath
 detectSteps
@@ -132,4 +134,4 @@ walkthrough
 webm
 webserver
 workingDirectory
-XPath
+XPath
