Skip to content

Revert "Add link to architecture diagram"#420

Merged
tracygardner merged 1 commit into
mainfrom
revert-416-architecture-diagram
Mar 18, 2026
Merged

Revert "Add link to architecture diagram"#420
tracygardner merged 1 commit into
mainfrom
revert-416-architecture-diagram

Conversation

@tracygardner

@tracygardner tracygardner commented Mar 18, 2026

Copy link
Copy Markdown
Contributor

Reverts #416

Summary by CodeRabbit

  • Documentation
    • Improved contributor guidelines with corrections and clearer language
    • Expanded contribution opportunities to include accessibility, translations, and UI/UX improvements

@coderabbitai

coderabbitai Bot commented Mar 18, 2026

Copy link
Copy Markdown
Contributor
📝 Walkthrough

Walkthrough

This PR corrects typos, improves formatting, and reorganizes content in the CONTRIBUTING.md file. It removes and reorders contributor category bullet points, fixes spelling errors throughout the document, adjusts phrasing for clarity, and introduces new contributor categories including write tests, accessibility improvements, translations, and UI/UX improvements.

Changes

Cohort / File(s) Summary
Documentation Updates
CONTRIBUTING.md
Fixed multiple typos (tets → tests, fiter → filter, Eaxh → Each), reformatted bullet points, reordered contributor categories, added new categories (Write tests, Accessibility improvements, Translations, UI/UX improvements), and adjusted example commands and descriptions for clarity.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

🐰 A doc so fine, now typos cease to hide,
Each word now spelled with careful, rightful pride!
Tests and access, translations bloom so bright,
Our CONTRIBUTING guide now shines just right! ✨

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Title check ⚠️ Warning The PR title 'Revert "Add link to architecture diagram"' claims to revert changes related to an architecture diagram link, but the actual changes show only formatting corrections and typo fixes in CONTRIBUTING.md with no architecture diagram modifications. Update the PR title to accurately reflect the actual changes (formatting and typo corrections in CONTRIBUTING.md) or verify that the correct files are included in this pull request.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch revert-416-architecture-diagram
📝 Coding Plan
  • Generate coding plan for human review comments

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@CONTRIBUTING.md`:
- Around line 107-123: Fix the remaining typos in the testing instructions:
change "tets" to "tests" in the bullet about tagging new tests (the line
mentioning tagging with `@new`), change "fiter" to "filter" in the sentence about
removing the tag, and change "Eaxh" to "Each" in the bullet describing the
testSuiteDefinitions array; these edits appear in the paragraph that mentions
describe/it and the bullets referencing testSuiteDefinitions.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 769ba36d-b899-41d1-bbb2-f5e018081784

📥 Commits

Reviewing files that changed from the base of the PR and between 67b4ec5 and eb7cbcc.

⛔ Files ignored due to path filters (1)
  • docs/images/flockxr-architecture.svg is excluded by !**/*.svg
📒 Files selected for processing (1)
  • CONTRIBUTING.md

Comment thread CONTRIBUTING.md
Comment on lines +107 to 123
#### Filtering tests and test results
* **Get fast feedback** by using the _Run all except @slow_ option
* **Run only your newest tests** by tagging those tets with @new and picking _Run tests tagged @new_
* **Focus on results** with the _failures_ / _passes_ links in report
* **Show the test code** by clicking on test name in the report
* **Tag slow tests with @slow** so that they can be run separately if needed.
* **Tag new tests with @new** so that you can fiter on those new tests. Remove tag when they're no longer new.

#### Tagging tests

To add a tag, change the `describe` or `it` text in unit tests to add a tag.
To add a tag, change the `describe` or `it` text in unit tests to add a tag.

#### Adding new unit test files / adding new tags to test runner

- Array `testSuiteDefinitions` corresponds to the test selection dropdown. Each test file, and each selectable tag, need a definition.
- Modify `testSuiteDefinitions` in `tests/tests.html` to pick up the test file. Each test file needs an entry.
- Modify `testSuiteDefinitions` in `tests/tests.html` to add tags or names to focus. Each tag needs an entry.
- Note that some test suites are selected/filtered on a name (the name from the top `describe` if there's only one) and others on tag (added to all top-level describes if several).
* Array `testSuiteDefinitions` corresponds to the test selection dropdown. Eaxh test file, and each selectable tag, need a definition.
* Modify `testSuiteDefinitions` in `tests/tests.html` to pick up the test file. Each test file needs an entry.
* Modify `testSuiteDefinitions` in `tests/tests.html` to add tags or names to focus. Each tag needs an entry.
* Note that some test suites are selected/filtered on a name (the name from the top `describe` if there's only one) and others on tag (added to all top-level describes if several).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix the remaining typos in the testing instructions.

There are still spelling errors in user-facing docs: Line 109 (tets), Line 113 (fiter), and Line 119 (Eaxh).

✏️ Proposed doc fix
-* **Run only your newest tests** by tagging those tets with `@new` and picking _Run tests tagged `@new_`
+* **Run only your newest tests** by tagging those tests with `@new` and picking _Run tests tagged `@new_`

-* **Tag new tests with `@new`** so that you can fiter on those new tests. Remove tag when they're no longer new.
+* **Tag new tests with `@new`** so that you can filter on those new tests. Remove tag when they're no longer new.

-* Array `testSuiteDefinitions` corresponds to the test selection dropdown. Eaxh test file, and each selectable tag, need a definition.
+* Array `testSuiteDefinitions` corresponds to the test selection dropdown. Each test file, and each selectable tag, need a definition.
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
#### Filtering tests and test results
* **Get fast feedback** by using the _Run all except @slow_ option
* **Run only your newest tests** by tagging those tets with @new and picking _Run tests tagged @new_
* **Focus on results** with the _failures_ / _passes_ links in report
* **Show the test code** by clicking on test name in the report
* **Tag slow tests with @slow** so that they can be run separately if needed.
* **Tag new tests with @new** so that you can fiter on those new tests. Remove tag when they're no longer new.
#### Tagging tests
To add a tag, change the `describe` or `it` text in unit tests to add a tag.
To add a tag, change the `describe` or `it` text in unit tests to add a tag.
#### Adding new unit test files / adding new tags to test runner
- Array `testSuiteDefinitions` corresponds to the test selection dropdown. Each test file, and each selectable tag, need a definition.
- Modify `testSuiteDefinitions` in `tests/tests.html` to pick up the test file. Each test file needs an entry.
- Modify `testSuiteDefinitions` in `tests/tests.html` to add tags or names to focus. Each tag needs an entry.
- Note that some test suites are selected/filtered on a name (the name from the top `describe` if there's only one) and others on tag (added to all top-level describes if several).
* Array `testSuiteDefinitions` corresponds to the test selection dropdown. Eaxh test file, and each selectable tag, need a definition.
* Modify `testSuiteDefinitions` in `tests/tests.html` to pick up the test file. Each test file needs an entry.
* Modify `testSuiteDefinitions` in `tests/tests.html` to add tags or names to focus. Each tag needs an entry.
* Note that some test suites are selected/filtered on a name (the name from the top `describe` if there's only one) and others on tag (added to all top-level describes if several).
#### Filtering tests and test results
* **Get fast feedback** by using the _Run all except `@slow_` option
* **Run only your newest tests** by tagging those tests with `@new` and picking _Run tests tagged `@new_`
* **Focus on results** with the _failures_ / _passes_ links in report
* **Show the test code** by clicking on test name in the report
* **Tag slow tests with `@slow`** so that they can be run separately if needed.
* **Tag new tests with `@new`** so that you can filter on those new tests. Remove tag when they're no longer new.
#### Tagging tests
To add a tag, change the `describe` or `it` text in unit tests to add a tag.
#### Adding new unit test files / adding new tags to test runner
* Array `testSuiteDefinitions` corresponds to the test selection dropdown. Each test file, and each selectable tag, need a definition.
* Modify `testSuiteDefinitions` in `tests/tests.html` to pick up the test file. Each test file needs an entry.
* Modify `testSuiteDefinitions` in `tests/tests.html` to add tags or names to focus. Each tag needs an entry.
* Note that some test suites are selected/filtered on a name (the name from the top `describe` if there's only one) and others on tag (added to all top-level describes if several).
🧰 Tools
🪛 LanguageTool

[grammar] ~109-~109: Ensure spelling is correct
Context: ...ly your newest tests** by tagging those tets with @new and picking _Run tests tagged...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)


[grammar] ~113-~113: Ensure spelling is correct
Context: ...g new tests with @new** so that you can fiter on those new tests. Remove tag when the...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)


[grammar] ~119-~119: Ensure spelling is correct
Context: ...esponds to the test selection dropdown. Eaxh test file, and each selectable tag, nee...

(QB_NEW_EN_ORTHOGRAPHY_ERROR_IDS_1)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@CONTRIBUTING.md` around lines 107 - 123, Fix the remaining typos in the
testing instructions: change "tets" to "tests" in the bullet about tagging new
tests (the line mentioning tagging with `@new`), change "fiter" to "filter" in the
sentence about removing the tag, and change "Eaxh" to "Each" in the bullet
describing the testSuiteDefinitions array; these edits appear in the paragraph
that mentions describe/it and the bullets referencing testSuiteDefinitions.

@tracygardner tracygardner merged commit f92267c into main Mar 18, 2026
6 checks passed
@tracygardner tracygardner deleted the revert-416-architecture-diagram branch March 19, 2026 20:57
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.

1 participant