Skip to content

Conversation

CharlesCNorton
Copy link
Contributor

@CharlesCNorton CharlesCNorton commented Sep 2, 2025

Various typo fixes. The first being:

als -> also in index.rst

Summary by CodeRabbit

  • Documentation
    • Fixed multiple typos and improved wording across user and enterprise documentation, integrations, and guides for clearer phrasing (e.g., "you data" → "your data"; "hompage" → "homepage"; "you many" → "you may"; spacing and punctuation fixes).
    • Added an Ubuntu troubleshooting note to install libssl-dev.
    • Editorial-only changes with no functional, API, or behavioral impact.

@CharlesCNorton CharlesCNorton self-assigned this Sep 2, 2025
@CharlesCNorton CharlesCNorton requested a review from a team as a code owner September 2, 2025 11:54
Copy link
Contributor

coderabbitai bot commented Sep 2, 2025

Walkthrough

Various documentation and policy text corrections: fixed typos, punctuation, spacing, and minor wording across multiple docs and one core docstring file. No functional, API, or control-flow changes.

Changes

Cohort / File(s) Summary
Documentation (multiple pages)
docs/source/index.rst, docs/source/brain.rst, docs/source/enterprise/app.rst, docs/source/enterprise/data_quality.rst, docs/source/enterprise/dataset_versioning.rst, docs/source/installation/troubleshooting.rst, docs/source/integrations/milvus.rst, docs/source/integrations/mongodb.rst, docs/source/integrations/pinecone.rst, docs/source/user_guide/app.rst, docs/source/user_guide/draw_labels.rst, docs/source/user_guide/export_datasets.rst, docs/source/user_guide/plots.rst
Multiple editorial fixes: typos, spacing, minor rephrasing, and one added Ubuntu package install command (sudo apt install libssl-dev) in troubleshooting. All changes are documentation-only; no code or behavioral changes.
Core docstrings
fiftyone/core/labels.py
Corrected docstring typos (e.g., "coorindate" → "coordinate", "coorindates" → "coordinates") in rotated box and GeoJSON polygon descriptions. No functional changes.
Policy
ISSUE_POLICY.md
Grammar and formatting fixes: "platforms its affects" → "platforms it affects", merged a broken sentence fragment regarding maintainers adopting ownership of severe installation issues. No semantic changes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

I hop through text with careful paws and ear,
nudging typos out so meanings are clear.
A nibble here, a tidy space or two,
docs breathe easier — carrot cheers from me to you. 🥕🐇

Pre-merge checks and finishing touches

❌ Failed checks (1 warning, 1 inconclusive)
Check name Status Explanation Resolution
Description Check ⚠️ Warning The description only mentions a single typo example and omits required sections from the template, such as detailed proposed changes, test coverage information, release notes selection, and affected areas. Please fill out the full PR template by listing all typo corrections under “What changes are proposed,” explaining how the fixes were tested, selecting the appropriate release notes option, and indicating which areas of FiftyOne are affected.
Title Check ❓ Inconclusive The title “Various typos” is overly broad and does not clearly specify the scope or location of the typo fixes, making it difficult for reviewers to quickly understand the primary change. Please update the title to specify the scope of the edits, for example “Fix typos across documentation and docstrings” or “Correct various documentation typos.”
✅ Passed checks (1 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch various-doc-fixes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

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

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (2)
docs/source/index.rst (2)

319-319: Fix typo: "you data" → "your data".

User-facing text; please correct.

-    :description: Are you using embeddings to analyze your data and models? Use FiftyOne's embeddings visualization capabilities to reveal hidden structure in you data, mine hard samples, pre-annotate data, recommend new samples for annotation, and more.
+    :description: Are you using embeddings to analyze your data and models? Use FiftyOne's embeddings visualization capabilities to reveal hidden structure in your data, mine hard samples, pre-annotate data, recommend new samples for annotation, and more.

333-333: Grammar: "Annotations mistakes" → "Annotation mistakes".

Singular adjective form.

-    :description: Annotations mistakes create an artificial ceiling on the performance of your model. However, finding these mistakes by hand is not feasible! Use FiftyOne to automatically identify possible label mistakes in your datasets.
+    :description: Annotation mistakes create an artificial ceiling on the performance of your model. However, finding these mistakes by hand is not feasible! Use FiftyOne to automatically identify possible label mistakes in your datasets.
🧹 Nitpick comments (1)
docs/source/index.rst (1)

417-417: Wording nit: avoid “powerful machine learning-powered”.

Redundant phrasing; simplify to “ML-powered”.

-The FiftyOne Brain is a library of powerful machine learning-powered
+The FiftyOne Brain is a library of ML-powered
📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between e185242 and fffd49d.

📒 Files selected for processing (1)
  • docs/source/index.rst (1 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: build
🔇 Additional comments (1)
docs/source/index.rst (1)

462-464: Typo fix LGTM.

"als" → "also" reads correctly; no semantic changes introduced.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
ISSUE_POLICY.md (1)

54-54: Fix article usage: “A FiftyOne …”, not “An FiftyOne …”.

Update four occurrences for grammatical correctness.

Apply this diff:

-   feature as an FiftyOne Plugin.
+   feature as a FiftyOne Plugin.
-3. An FiftyOne maintainer reproduces the bug and provides feedback about how to
+3. A FiftyOne maintainer reproduces the bug and provides feedback about how to
-3. An FiftyOne maintainer confirms the documentation issue and provides
+3. A FiftyOne maintainer confirms the documentation issue and provides
-3. An FiftyOne maintainer confirms the installation issue and provides feedback
+3. A FiftyOne maintainer confirms the installation issue and provides feedback

Also applies to: 65-65, 83-83, 99-99

🧹 Nitpick comments (3)
ISSUE_POLICY.md (3)

64-64: Tighten phrasing: remove stray “request”.

"route to request appropriate maintainers" → "route to appropriate maintainers".

-   route to request appropriate maintainers.
+   route to appropriate maintainers.

46-46: Concise style: “indicate priority” reads better.

Swap “give an indication of priority” with “indicate priority” for brevity.

-   ... needed from the author, give an indication of priority, and route ...
+   ... needed from the author, indicate priority, and route ...

Also applies to: 63-63, 80-80, 97-97


22-22: Optional: standardize heading capitalization.

Choose either Title Case or sentence case across section headings for consistency (currently “Feature Requests” vs “Bug reports/Documentation fixes/Installation issues”).

Also applies to: 56-56, 73-73, 90-90

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 5684dbc and 60426ff.

📒 Files selected for processing (1)
  • ISSUE_POLICY.md (1 hunks)
🧰 Additional context used
🪛 LanguageTool
ISSUE_POLICY.md

[grammar] ~95-~95: There might be a mistake here.
Context: ... the issue and the platforms it affects. 2. The issue is triaged ...

(QB_NEW_EN)


[style] ~97-~97: ‘give an indication of’ might be wordy. Consider a shorter alternative.
Context: ...formation is needed from the author, give an indication of priority, and route the issue to app...

(EN_WORDINESS_PREMIUM_GIVE_AN_INDICATION_OF)


[grammar] ~98-~98: There might be a mistake here.
Context: ...the issue to appropriate maintainers. 3. An FiftyOne maintainer confirms the inst...

(QB_NEW_EN)


[grammar] ~100-~100: There might be a mistake here.
Context: ...eedback about how to implement a fix. 4. After an approach has been agreed upon, ...

(QB_NEW_EN)


[grammar] ~103-~103: There might be a mistake here.
Context: ...lation issues to ensure a timely fix. 5. The fix owner begins implementing the fi...

(QB_NEW_EN)

⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (1)
  • GitHub Check: build
🔇 Additional comments (2)
ISSUE_POLICY.md (2)

95-95: LGTM: grammar fix reads correctly.

"the platforms it affects" is correct and clearer than the prior phrasing.


102-103: LGTM: merged fragment improves readability.

The sentence now scans cleanly and preserves intent.

@CharlesCNorton CharlesCNorton changed the title typo fix: als -> also in index.rst Various typos (WIP) Sep 5, 2025
@CharlesCNorton CharlesCNorton requested a review from a team as a code owner September 8, 2025 17:09
@CharlesCNorton CharlesCNorton added the documentation Documentation work label Sep 8, 2025
@CharlesCNorton CharlesCNorton changed the title Various typos (WIP) Various typos Sep 8, 2025
- Fixed typos in multiple documentation files
- Corrected 'coorindate' to 'coordinate' in labels.py
- Fixed grammar and spelling errors across user guides and integration docs
Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e6a8456 and ca4119e.

📒 Files selected for processing (15)
  • ISSUE_POLICY.md (1 hunks)
  • docs/source/brain.rst (2 hunks)
  • docs/source/enterprise/app.rst (2 hunks)
  • docs/source/enterprise/data_quality.rst (1 hunks)
  • docs/source/enterprise/dataset_versioning.rst (1 hunks)
  • docs/source/index.rst (3 hunks)
  • docs/source/installation/troubleshooting.rst (2 hunks)
  • docs/source/integrations/milvus.rst (2 hunks)
  • docs/source/integrations/mongodb.rst (1 hunks)
  • docs/source/integrations/pinecone.rst (1 hunks)
  • docs/source/user_guide/app.rst (1 hunks)
  • docs/source/user_guide/draw_labels.rst (1 hunks)
  • docs/source/user_guide/export_datasets.rst (1 hunks)
  • docs/source/user_guide/plots.rst (1 hunks)
  • fiftyone/core/labels.py (2 hunks)
🧰 Additional context used
🧠 Learnings (2)
📚 Learning: 2025-09-10T03:01:27.501Z
Learnt from: swheaton
PR: voxel51/fiftyone#6334
File: fiftyone/core/expressions.py:2727-2741
Timestamp: 2025-09-10T03:01:27.501Z
Learning: FiftyOne requires MongoDB >= 6.0 as documented at https://docs.voxel51.com/user_guide/config.html#using-a-different-mongodb-version

Applied to files:

  • docs/source/integrations/mongodb.rst
📚 Learning: 2025-09-10T19:53:08.432Z
Learnt from: AdonaiVera
PR: voxel51/fiftyone#6337
File: docs/source/tutorials/dinov3.ipynb:121-124
Timestamp: 2025-09-10T19:53:08.432Z
Learning: The `foz.load_zoo_dataset()` function supports loading datasets from external sources including GitHub URLs (e.g., "https://github.com/voxel51/coco-2017"), which is different from loading built-in zoo datasets by name (e.g., "coco-2017"). GitHub URL loading allows access to custom datasets not available in the standard FiftyOne Dataset Zoo.

Applied to files:

  • docs/source/index.rst
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (12)
  • GitHub Check: test / test-python (ubuntu-latest-m, 3.10)
  • GitHub Check: test-windows / test-python (windows-latest, 3.11)
  • GitHub Check: test-windows / test-python (windows-latest, 3.10)
  • GitHub Check: test-windows / test-python (windows-latest, 3.12)
  • GitHub Check: test-windows / test-python (windows-latest, 3.9)
  • GitHub Check: test / test-python (ubuntu-latest-m, 3.12)
  • GitHub Check: test / test-python (ubuntu-latest-m, 3.11)
  • GitHub Check: test / test-python (ubuntu-latest-m, 3.9)
  • GitHub Check: e2e / test-e2e
  • GitHub Check: test / test-app
  • GitHub Check: build / build
  • GitHub Check: build
🔇 Additional comments (2)
docs/source/user_guide/plots.rst (1)

49-50: Clean doc phrasing

Removing the redundant “attribute” makes the sentence read smoothly. Nice catch.

docs/source/user_guide/draw_labels.rst (1)

49-49: Nice grammar fix.

“render” reads correctly now. ✅

Comment on lines +243 to 245
If you encounter a `psutil.NoSuchProcessExists` exists when importing
`fiftyone`, you are likely missing the C++ libraries MongoDB requires.

Copy link
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 typo in psutil error description.

The text references a nonexistent psutil.NoSuchProcessExists symbol and still has a duplicated “exists”. Please correct the exception name and sentence.

Apply this patch:

-If you encounter a `psutil.NoSuchProcessExists` exists when importing
-`fiftyone`, you are likely missing the C++ libraries MongoDB requires.
+If you encounter a `psutil.NoSuchProcess` error when importing `fiftyone`,
+you are likely missing the C++ libraries that MongoDB requires.
📝 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
If you encounter a `psutil.NoSuchProcessExists` exists when importing
`fiftyone`, you are likely missing the C++ libraries MongoDB requires.
If you encounter a `psutil.NoSuchProcess` error when importing `fiftyone`,
you are likely missing the C++ libraries that MongoDB requires.
🤖 Prompt for AI Agents
In docs/source/installation/troubleshooting.rst around lines 243 to 245, the
sentence incorrectly references a nonexistent psutil.NoSuchProcessExists symbol
and repeats the word "exists"; update the exception name to psutil.NoSuchProcess
and remove the duplicated "exists", rewriting the sentence to read something
like: "If you encounter a `psutil.NoSuchProcess` when importing `fiftyone`, you
are likely missing the C++ libraries MongoDB requires." Ensure backticks
surround the exception and module name exactly as shown.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Documentation work

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants