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

[HOLD] Update Docs for Fiftyone Enterprise #5096

Draft
wants to merge 7 commits into
base: main
Choose a base branch
from

Conversation

Anddraca
Copy link
Contributor

@Anddraca Anddraca commented Nov 12, 2024

What changes are proposed in this pull request?

Modifying the docs to change the verbage of Teams -> Enterprise

Broken into 2 commits: one is lower-touch and only replaces the user facing elements with literal Teams -- shouldn't impact any docs building or functionality

The second commit also removes any other references to teams and renames dirs and filenames that previously references teams -- should remove all references EXCEPT some environment variables, which I don't think we should switch over right now without additional testing.

Happy to merge both if this change doesn't impact doc building or other references, but if the second is too much this close to release, we can only keep the first commit so that at least the visible docs will be correct.

Summary by CodeRabbit

Release Notes

  • New Features

    • Rebranding from "FiftyOne Teams" to "FiftyOne Enterprise" across all documentation and user interfaces.
    • Introduction of new sections in documentation, including "Dataset Zoo" and "Model Zoo."
  • Documentation Updates

    • Enhanced clarity on API connections, configuration options, and plugin management.
    • Updated installation instructions and environment configurations to reflect the new branding.
  • Bug Fixes

    • Various performance improvements and bug fixes noted in the release history.

These changes enhance user experience and align the platform with its enterprise offerings.

@Anddraca Anddraca requested a review from brimoor November 12, 2024 19:40
Copy link
Contributor

coderabbitai bot commented Nov 12, 2024

Walkthrough

The pull request encompasses a comprehensive rebranding of the FiftyOne documentation, replacing all instances of "FiftyOne Teams" with "FiftyOne Enterprise." This includes updates across various documentation files, such as README, installation guides, API connection, and plugin management. Additionally, several sections have been clarified or expanded, particularly regarding configuration settings, user roles, and plugin development. The overall structure and functionality of the documentation remain intact, with a focus on aligning the terminology with the new branding.

Changes

File Path Change Summary
docs/README.md Updated "Teams SDK" to "Enterprise SDK"; modified documentation build command path accordingly.
docs/generate_docs.bash Changed references from "fiftyone-teams" to "fiftyone-enterprise"; updated usage descriptions.
docs/source/_templates/layout.html Updated navigation and footer to reflect "FiftyOne Enterprise" branding.
docs/source/cheat_sheets/fiftyone_terminology.rst Replaced "FiftyOne Teams" with "FiftyOne Enterprise"; updated associated URL.
docs/source/deprecation.rst Clarified support end dates; updated references from "Teams" to "Enterprise."
docs/source/environments/index.rst Updated terminology from "Teams" to "Enterprise" in cloud storage context; added AWS/Google/Azure instructions.
docs/source/faq/index.rst Updated "FiftyOne Teams" to "FiftyOne Enterprise" in FAQ responses.
docs/source/getting_started/install.rst Changed "FiftyOne Teams" references to "FiftyOne Enterprise" in installation notes.
docs/source/index.rst Updated section header from "FiftyOne Teams" to "FiftyOne Enterprise"; added "Dataset Zoo" and "Model Zoo" sections.
docs/source/plugins/developing_plugins.rst Added sections on publishing plugins and quick examples; clarified development setup.
docs/source/plugins/using_plugins.rst Updated references from "Teams" to "Enterprise" in plugin usage documentation.
docs/source/release-notes.rst Rebranded all mentions of "FiftyOne Teams" to "FiftyOne Enterprise" across multiple versions.
docs/source/user_guide/config.rst Updated default_batcher configuration to target "FiftyOne Enterprise SDK"; added new fields.
docs/source/teams/api_connection.rst Changed "Teams" to "Enterprise" in API connection documentation.
docs/source/teams/cloud_media.rst Updated branding from "Teams" to "Enterprise" in cloud media documentation.
docs/source/teams/dataset_versioning.rst Changed "Teams" to "Enterprise" in dataset versioning documentation.
docs/source/teams/index.rst Comprehensive rebranding from "Teams" to "Enterprise" throughout the document.
docs/source/teams/installation.rst Updated installation documentation for "FiftyOne Enterprise"; clarified deployment environment.
docs/source/teams/management_sdk.rst Renamed "Teams Management SDK" to "Enterprise Management SDK"; updated descriptions.
docs/source/teams/migrations.rst Changed references from "Teams" to "Enterprise" in migration documentation.
docs/source/teams/overview.rst Rebranding from "FiftyOne Teams" to "FiftyOne Enterprise"; clarified compatibility.
docs/source/teams/pluggable_auth.md Updated branding to "FiftyOne Enterprise"; retained functionality descriptions.
docs/source/teams/roles_and_permissions.rst Updated user roles and permissions documentation to reflect "FiftyOne Enterprise."
docs/source/teams/secrets.rst Changed "FiftyOne Teams Secrets" to "FiftyOne Enterprise Secrets"; updated management processes.
docs/source/teams/teams_app.rst Updated from "FiftyOne Teams App" to "FiftyOne Enterprise App"; emphasized expanded features.
docs/source/teams/teams_plugins.rst Comprehensive rebranding from "Teams" to "Enterprise"; updated plugin management references.

Possibly related PRs

Suggested labels

documentation, cleaning

Suggested reviewers

  • findtopher
  • brimoor

🐰 In the garden, we hop with glee,
FiftyOne's new name, as bright as can be!
From Teams to Enterprise, we cheer and sing,
A fresh new start, oh what joy it brings!
With docs all updated, we’ll guide the way,
For every data journey, come join the play! 🌼


📜 Recent review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 3301e1d and c41a667.

📒 Files selected for processing (1)
  • docs/source/teams/api_connection.rst (4 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/source/teams/api_connection.rst

Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

--------------------
*Released October 31, 2024*

- Fixed an issue that prevented `delegation_target` from being properly set when
running delegated operations with orchestrator registration enabled

FiftyOne Teams 2.1.1
FiftyOne Enterprise 2.1.1
Copy link
Contributor Author

Choose a reason for hiding this comment

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

Let me know if there's a preference for the release notes that reference previous versions of the tool to remain "Fiftyone Teams" since that is what they were called at the time. I don't know if this would help with searching or to minimize confusion.

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: 8

🧹 Outside diff range and nitpick comments (19)
docs/generate_docs.bash (1)

18-18: Update variable name to match new terminology

While the help text has been updated to reference "Enterprise", the variable name PATH_TO_TEAMS still uses the old terminology. Consider updating it to PATH_TO_ENTERPRISE for consistency.

-PATH_TO_TEAMS=""
+PATH_TO_ENTERPRISE=""

Also applies to: 25-25

docs/source/enterprise/api_connection.rst (2)

33-35: Consider enhancing the API URI format documentation.

While the rebranding changes look good, consider adding an example format for the API URI to help users understand what to expect (e.g., https://api.fiftyone.ai/v1 or similar).


Line range hint 1-117: Documentation maintains clarity while implementing rebranding.

The rebranding from Teams to Enterprise has been implemented consistently throughout the document while maintaining the technical accuracy of the content. The decision to keep environment variable names unchanged aligns with the PR objectives.

Consider creating a documentation test that validates all cross-references and image paths to catch any broken links early in the CI pipeline.

docs/source/enterprise/index.rst (2)

Missing Documentation Page: pluggable_auth.rst

The referenced documentation page pluggable_auth.rst does not exist in the docs/source/enterprise directory.

  • Path: docs/source/enterprise/pluggable_auth.rst
🔗 Analysis chain

Line range hint 134-149: Verify all referenced documentation pages exist.

The table of contents has been updated with Enterprise-specific pages.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify that all referenced RST files exist
# Test: Check if all documentation files exist in the enterprise directory

cd docs/source/enterprise
for page in "overview" "installation" "api_connection" "cloud_media" "roles_and_permissions" "dataset_versioning" "enterprise_app" "management_sdk" "enterprise_plugins" "secrets" "migrations" "pluggable_auth"; do
  if [ ! -f "${page}.rst" ]; then
    echo "Missing: ${page}.rst"
  fi
done

Length of output: 3049


Broken Enterprise URLs Found

The updated Enterprise URLs in docs/source/enterprise/index.rst are returning 404 errors.

  • https://voxel51.com/fiftyone-enterprise
  • https://voxel51.com/schedule-enterprise-workshop

Please verify and update these URLs to point to the correct destinations.

🔗 Analysis chain

Line range hint 1-34: LGTM! Verify the updated URLs are accessible.

The header and social links have been correctly updated to reflect the Enterprise branding.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify that the new Enterprise URLs are accessible
# Test: Check if the URLs return valid responses

for url in "https://voxel51.com/fiftyone-enterprise" "https://voxel51.com/schedule-enterprise-workshop"; do
  curl -s -I "$url" | head -n 1 | grep "HTTP/"
done

Length of output: 177


Script:

#!/bin/bash
# Description: Verify that the new Enterprise URLs are accessible
# Test: Check if the URLs return valid responses

for url in "https://voxel51.com/fiftyone-enterprise" "https://voxel51.com/schedule-enterprise-workshop"; do
  curl -s -I "$url" | head -n 1 | grep "HTTP/"
done

Length of output: 401

docs/source/enterprise/migrations.rst (3)

30-32: Add quotes around version specification

To prevent potential shell interpretation issues, the version specification should be quoted.

Apply this improvement:

-    pip install --index-url https://${TOKEN}@pypi.fiftyone.ai fiftyone==${VERSION}
+    pip install --index-url https://${TOKEN}@pypi.fiftyone.ai "fiftyone==${VERSION}"

44-50: Consider adding version compatibility information

While the workflow steps are clear, it would be helpful to add information about version compatibility requirements between the SDK and the Enterprise App infrastructure.

Consider adding a note like:

.. note::

    Before upgrading, ensure that the SDK version you're upgrading to is compatible
    with your target Enterprise App infrastructure version. Incompatible versions
    may cause connectivity issues.

136-140: Add guidance for large dataset migrations

The migration instructions should include considerations for handling large datasets.

Consider adding a note like:

.. note::

    When migrating large datasets, consider:
    
    - Breaking the migration into smaller batches
    - Monitoring system resources during the export/import process
    - Planning for sufficient storage space in both source and destination
    - Estimating the time required for media uploads to cloud storage
docs/source/enterprise/pluggable_auth.md (5)

25-25: Fix spacing in "FiftyOneEnterprise"

There should be a space between "FiftyOne" and "Enterprise".

-FiftyOneEnterprise
+FiftyOne Enterprise

34-34: Fix grammatical structure

The sentence structure needs improvement.

-In internal mode, FiftyOne Enterprise the CAS replaces Auth0.
+In internal mode, the CAS replaces Auth0 in FiftyOne Enterprise.

Line range hint 67-68: Update URL reference to use Enterprise instead of Teams

The URL still contains a reference to "Teams" which should be updated to "Enterprise" for consistency.

-https://<YOUR_FIFTYONE_TEAMS_URL>/cas/configurations
+https://<YOUR_FIFTYONE_ENTERPRISE_URL>/cas/configurations
🧰 Tools
🪛 LanguageTool

[grammar] ~66-~66: The word “login” is a noun. The verb is spelled with a white space.
Context: ...ges/enterprise/cas/cas_sign_in.png) To login to this application navigate to `https:...

(NOUN_VERB_CONFUSION)


124-126: Maintain consistent terminology in migration steps

The steps should consistently use "Enterprise" terminology.

-1. Creating a FiftyOne Enterprise user profile via `POST /cas/api/users`.
-1. Assigning the user to the default organization through a membership entry.
-1. Linking the user's account to the new authentication provider by creating an
+1. Create a FiftyOne Enterprise user profile via `POST /cas/api/users`
+2. Assign the user to the default organization through a membership entry
+3. Link the user's account to the new authentication provider by creating an

Line range hint 141-142: Update URL reference in Getting Started section

The URL still contains a reference to "Teams" which should be updated to "Enterprise" for consistency.

-https://<YOUR_FIFTYONE_TEAMS_URL>/cas/configurations
+https://<YOUR_FIFTYONE_ENTERPRISE_URL>/cas/configurations
docs/source/enterprise/cloud_media.rst (1)

35-35: Use a more descriptive example dataset name

Consider using a more meaningful example dataset name that reflects a real-world scenario, such as "cloud-backed-images" or "s3-backed-dataset".

-    dataset = fo.load_dataset("a-enterprise-dataset")
+    dataset = fo.load_dataset("cloud-backed-images")

Also applies to: 49-49

docs/source/enterprise/enterprise_plugins.rst (4)

15-20: Fix indentation in the note block

The note block's content has inconsistent indentation which may affect rendering.

.. note::

-    What can you do with plugins? Check out
-    :ref:`delegated operations <enterprise-delegated-operations>` to see some quick
-    examples, then check out the
-    `FiftyOne plugins <https://github.com/voxel51/fiftyone-plugins>`_
-    repository for a growing collection of prebuilt plugins that you can add to
-    your Enterprise deployment!
+   What can you do with plugins? Check out
+   :ref:`delegated operations <enterprise-delegated-operations>` to see some quick
+   examples, then check out the
+   `FiftyOne plugins <https://github.com/voxel51/fiftyone-plugins>`_
+   repository for a growing collection of prebuilt plugins that you can add to
+   your Enterprise deployment!

Line range hint 503-505: Update terminology for consistency

The word "Team's" should be updated to "Enterprise" for consistency with the rebranding.

-    The Orchestrator will need to have all of the required dependencies
-    installed for running your Team's operations. For example, if running the
+    The Orchestrator will need to have all of the required dependencies
+    installed for running your Enterprise operations. For example, if running the

Line range hint 481-491: Add security note for API key configuration

The FIFTYONE_API_KEY environment variable configuration should include a security warning about protecting the admin API key.

| FIFTYONE_API_KEY          | api_key              | The API key of an admin user that is used like a service account,  |
|                           |                      | to resolve secrets and check permissions                           |
+|                           |                      | Note: Protect this key as it provides admin-level access.          |

Line range hint 571-574: Add error handling guidance for Airflow setup

Consider adding error handling guidance and troubleshooting steps for common issues during Airflow setup.

Add a note section like:

.. note::

   If you encounter permission errors during Airflow setup, ensure that:
   - The user has sudo privileges
   - The necessary ports are open in your firewall
   - The service account has required permissions
docs/source/release-notes.rst (1)

1519-1529: Consider adding more details about the debug logging

While the release note is clear, it would be helpful to provide more specifics about:

  • What kind of debug events are being logged
  • How to access/view these logs
📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 2b28b83 and b4a3c89.

⛔ Files ignored due to path filters (59)
  • docs/source/images/enterprise/admin_add_users_to_team.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/admin_create_group.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/admin_roles_page.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/admin_team_groups_page.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/admin_team_users_page.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/airflow.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/api_key_delete.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/api_key_generate.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/api_key_generated.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/cas/cas_api_docs.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/cas/cas_sign_in.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/cloud_creds_add_btn.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/cloud_creds_modal_blank.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/create_dataset.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/create_secret_form.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/dataset_access.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/dataset_basic_info.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/dataset_danger_zone.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/dataset_default_access.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/dataset_search_bar.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/dataset_search_fields.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/dataset_specific_access.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/enterprise_architecture.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/hero.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/homepage.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/install_fiftyone.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/ordering_datasets.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/pinned_datasets.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_disable.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_install.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_install_btn.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_install_success.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_operators_btn.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_operators_disable.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_operators_perms.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_operators_perms2.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_org_settings.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_page.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_uninstall_btn.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_upgrade_btn.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_upgrade_page.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/plugins_upgrade_success_page.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/samples_page.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/secrets_page.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/share_dataset.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/user_invitation.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/archive-snapshot.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/browse-banner-dropdown.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/browse-banner-right.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/browse-banner-right2.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/browse-button.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/create-refresh-button.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/create-save-button.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/delete-snapshot.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/history-new-snapshot.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/history-tab-button.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/rollback-snapshot.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/snapshot-list.png is excluded by !**/*.png, !**/*.png
  • docs/source/images/enterprise/versioning/unarchive-snapshot.png is excluded by !**/*.png, !**/*.png
📒 Files selected for processing (28)
  • docs/README.md (1 hunks)
  • docs/generate_docs.bash (4 hunks)
  • docs/source/_templates/layout.html (2 hunks)
  • docs/source/cheat_sheets/fiftyone_terminology.rst (1 hunks)
  • docs/source/conf.py (3 hunks)
  • docs/source/deprecation.rst (1 hunks)
  • docs/source/enterprise/api_connection.rst (6 hunks)
  • docs/source/enterprise/cloud_media.rst (14 hunks)
  • docs/source/enterprise/dataset_versioning.rst (22 hunks)
  • docs/source/enterprise/enterprise_app.rst (8 hunks)
  • docs/source/enterprise/enterprise_plugins.rst (25 hunks)
  • docs/source/enterprise/index.rst (7 hunks)
  • docs/source/enterprise/installation.rst (19 hunks)
  • docs/source/enterprise/management_sdk.rst (8 hunks)
  • docs/source/enterprise/migrations.rst (8 hunks)
  • docs/source/enterprise/overview.rst (3 hunks)
  • docs/source/enterprise/pluggable_auth.md (8 hunks)
  • docs/source/enterprise/roles_and_permissions.rst (15 hunks)
  • docs/source/enterprise/secrets.rst (3 hunks)
  • docs/source/environments/index.rst (1 hunks)
  • docs/source/faq/index.rst (1 hunks)
  • docs/source/getting_started/install.rst (1 hunks)
  • docs/source/index.rst (2 hunks)
  • docs/source/plugins/developing_plugins.rst (1 hunks)
  • docs/source/plugins/using_plugins.rst (3 hunks)
  • docs/source/recipes/creating_views.ipynb (1 hunks)
  • docs/source/release-notes.rst (53 hunks)
  • docs/source/user_guide/config.rst (1 hunks)
✅ Files skipped from review due to trivial changes (8)
  • docs/source/enterprise/dataset_versioning.rst
  • docs/source/enterprise/enterprise_app.rst
  • docs/source/enterprise/installation.rst
  • docs/source/enterprise/management_sdk.rst
  • docs/source/enterprise/overview.rst
  • docs/source/faq/index.rst
  • docs/source/plugins/using_plugins.rst
  • docs/source/recipes/creating_views.ipynb
🔇 Additional comments (38)
docs/source/deprecation.rst (1)

35-35: LGTM! Rebranding change looks correct.

The terminology change from "Teams" to "Enterprise" aligns with the PR objectives.

Let's verify if there are any remaining "Teams" references in the documentation:

✅ Verification successful

All "Teams" references successfully removed.

No remaining instances of "FiftyOne Teams" found in the documentation.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Search for remaining "Teams" references in documentation
# Expected: No instances of "FiftyOne Teams" should remain in the docs

echo "Searching for 'FiftyOne Teams' in documentation..."
rg -i "fiftyone\s+teams" docs/

echo "Searching for potentially missed file/directory names containing 'teams'..."
fd -i teams docs/

Length of output: 336

docs/source/enterprise/secrets.rst (3)

12-19: LGTM! Clear and consistent description

The main description effectively explains the purpose and benefits of the Secrets interface while maintaining consistent Enterprise branding.


Line range hint 51-95: LGTM! Comprehensive coverage of secret usage

This section effectively covers:

  • Plugin configuration requirements
  • Runtime secret access
  • Environment compatibility
  • Multiple deployment scenarios

The examples and explanations are clear and technically accurate.


28-29: Verify the updated image paths

The image paths have been updated to use the enterprise directory. Let's verify these images exist and are accessible.

Also applies to: 35-36

✅ Verification successful

Image paths verified successfully

All referenced images exist in the docs/source/images/enterprise directory.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify that the referenced images exist in the correct location
fd "secrets_page.png|create_secret_form.png" "docs/source/images/enterprise"

Length of output: 176

docs/generate_docs.bash (3)

Line range hint 77-91: LGTM! Clear and accurate feedback messages

The symlink creation logic and feedback messages have been appropriately updated to reflect the Enterprise branding.


Line range hint 130-134: LGTM! Clean symlink removal

The symlink removal logic and comment have been appropriately updated to reflect the Enterprise branding.


Line range hint 1-139: Verify documentation build process

While the terminology updates look good, it would be valuable to verify that the documentation builds correctly with these changes.

docs/README.md (1)

69-75: LGTM! The Enterprise SDK section updates look consistent.

The changes align with the rebranding effort from Teams to Enterprise, maintaining the documentation's structure while updating the terminology.

Let's verify that there are no lingering references to the old path:

docs/source/enterprise/api_connection.rst (3)

72-72: Verify image path updates.

The image paths have been updated from /images/teams/ to /images/enterprise/. Let's ensure these images exist in the new location.

#!/bin/bash
# Description: Verify that the referenced images exist
# Check for the existence of the new image files
fd "api_key_generate.png|api_key_generated.png" docs/source/images/enterprise/

Also applies to: 79-79


108-108: Verify deletion image path.

The image path has been updated to use the enterprise directory. Let's verify this image exists.

#!/bin/bash
# Description: Verify that the API key deletion image exists
fd "api_key_delete.png" docs/source/images/enterprise/

Line range hint 1-21: LGTM! Verify cross-references.

The rebranding changes in the introduction section are consistent. References have been properly updated from Teams to Enterprise.

Let's verify all cross-references are valid:

✅ Verification successful

Verified: All cross-references have been successfully updated and are valid.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify that the referenced sections exist in the documentation
# Check for enterprise-python-sdk reference
rg -l "enterprise-python-sdk" docs/
# Check for configuring-mongodb-connection reference
rg -l "configuring-mongodb-connection" docs/

Length of output: 197


Script:

#!/bin/bash
# Description: Verify that the referenced sections exist in the documentation
# Check for enterprise-python-sdk reference
rg -l 'enterprise-python-sdk' docs/
# Check for configuring-mongodb-connection reference
rg -l 'configuring-mongodb-connection' docs/

Length of output: 651

docs/source/enterprise/index.rst (3)

35-42: LGTM! Clear and accurate product description.

The description effectively communicates the Enterprise offering while maintaining the important backwards compatibility statement.


Line range hint 60-116: LGTM! Consistent Enterprise branding across all callouts.

The callout items have been thoroughly updated to reflect Enterprise branding while maintaining consistent formatting and structure.


46-48: Verify the new enterprise hero image exists.

The image path has been updated to reflect the Enterprise branding.

#!/bin/bash
# Description: Verify that the enterprise hero image exists
# Test: Check if the image file exists in the new path

fd "hero.png" docs/source/images/enterprise/
docs/source/cheat_sheets/fiftyone_terminology.rst (2)

23-24: LGTM! Rebranding changes look accurate.

The terminology update from "Teams" to "Enterprise" is clear and consistent with the PR objectives. The description maintains the same professional tone while accurately representing the enterprise-grade capabilities.


24-24: Verify the Enterprise URL accessibility.

Let's ensure the new URL is accessible and consistent across documentation.

✅ Verification successful

The Enterprise URL is accessible and consistently used across all documentation.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify the Enterprise URL accessibility and consistency

# Check if the old Teams URL still exists in any documentation files
echo "Checking for any remaining references to the old Teams URL..."
rg -l "voxel51.com/fiftyone-teams"

# Check for consistency of the new Enterprise URL
echo "Checking for consistency of the new Enterprise URL..."
rg -l "voxel51.com/fiftyone-enterprise"

Length of output: 463

docs/source/enterprise/migrations.rst (1)

1-14: LGTM: References and introduction are properly updated

The terminology changes from "Teams" to "Enterprise" have been consistently applied throughout the introduction and cross-references.

docs/source/getting_started/install.rst (2)

15-15: LGTM: Terminology update is consistent with rebranding.

The reference change from "Teams" to "Enterprise" is correctly implemented and maintains proper RST syntax.


15-15: Verify complete rebranding coverage.

Let's ensure we haven't missed any "Teams" references that should be updated to "Enterprise".

✅ Verification successful

Rebranding coverage verified successfully. All "Teams" references are updated to "Enterprise", excluding environment variables as per PR objectives.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Search for remaining "Teams" references in documentation
# Note: Excluding environment variables as mentioned in PR objectives

# Search for "Teams" in RST files
echo "Searching for 'Teams' references in documentation..."
rg -i "teams" "docs/source/" \
  --type rst \
  --glob "!{env,environment}*" \
  -C 2

# Search for "teams" in filenames
echo -e "\nSearching for 'teams' in filenames..."
fd "teams" "docs/source/" --type f

Length of output: 1532

docs/source/conf.py (1)

16-16: Verify import order change impact

Moving the fiftyone.constants import before custom imports but after sys.path.insert could affect module resolution.

#!/bin/bash
# Description: Check if fiftyone.constants is imported correctly in other files
# and verify no circular imports are introduced

# Search for other files importing fiftyone.constants
rg -l "import.*fiftyone.constants" --type python

# Check for potential circular imports
rg -l "from custom_directives import|import custom_directives" --type python
docs/source/_templates/layout.html (2)

45-45: Verify template variable definition

The branding update from "Teams" to "Enterprise" looks good. However, ensure that the template variable link_fiftyone_enterprise is properly defined in the configuration.

✅ Verification successful

Template variable link_fiftyone_enterprise is properly defined

The template variable link_fiftyone_enterprise is correctly defined in the configuration files.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Search for the template variable definition
rg -l "link_fiftyone_enterprise" docs/source/conf.py docs/source/_templates/

Length of output: 131


135-135: Check for any remaining "Teams" references

The footer branding update looks good and is consistent with the navigation menu change.

docs/source/enterprise/roles_and_permissions.rst (5)

1-18: LGTM! Document structure and introduction are well-organized.

The reference anchor and introduction have been properly updated to reflect the Enterprise branding while maintaining clarity about the collaboration features.


Line range hint 135-295: LGTM! Permissions section is comprehensive and accurate.

The permissions documentation is well-structured and all references have been properly updated to use the "enterprise-" prefix. The explanation of permission levels and inheritance is clear and accurate.


Line range hint 105-112: Verify UI path consistency

The text mentions "Settings > Team > Groups". As part of the Enterprise rebranding, should this be updated to "Settings > Enterprise > Groups"?

#!/bin/bash
# Search for other occurrences of similar UI paths
rg -i "settings.*team.*groups" --type rst

300-301: Verify UI path consistency

The text mentions "Settings > Security > Roles". Please verify if this UI path is correct and consistent with the Enterprise rebranding.

#!/bin/bash
# Search for other occurrences of similar UI paths
rg -i "settings.*security.*roles" --type rst

31-31: Verify image paths after directory renaming

Since the PR involves renaming directories, please verify that all image paths under /images/enterprise/ are correct and the images are present in the new location.

#!/bin/bash
# Check if the referenced images exist in the enterprise directory
for img in admin_team_users_page.png admin_team_groups_page.png admin_create_group.png admin_add_users_to_team.png dataset_default_access.png share_dataset.png dataset_specific_access.png admin_roles_page.png; do
    if [ ! -f "docs/source/images/enterprise/$img" ]; then
        echo "Missing image: $img"
    fi
done

Also applies to: 115-115, 122-122, 126-126, 178-178, 199-199, 203-203, 305-305

docs/source/index.rst (1)

480-480: LGTM: Section title updated consistently with rebranding

The table of contents entry has been updated to reflect the rebranding while maintaining the existing structure and styling.

#!/bin/bash
# Description: Verify consistency of enterprise-related terms in the documentation
# Expected: No remaining references to "teams" in the enterprise documentation

# Search for any remaining "teams" references in RST files
rg -i "teams" --type rst
docs/source/enterprise/pluggable_auth.md (2)

78-80: LGTM!

The Identity Providers section correctly uses the Enterprise terminology and provides clear configuration instructions.


171-175: LGTM!

The JavaScript hooks and configuration sections are well-documented and correctly use the Enterprise terminology.

docs/source/enterprise/cloud_media.rst (1)

13-14: Verify the cross-reference target exists

Please ensure that the target enterprise-cloud-credentials exists in the documentation.

✅ Verification successful

Cross-reference target exists

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check if the cross-reference target exists
rg -l "^\.\. _enterprise-cloud-credentials:$" docs/source/

Length of output: 100

docs/source/enterprise/enterprise_plugins.rst (1)

686-688: LGTM: Image reference updated correctly

The image reference has been properly updated to use the new enterprise path.

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

66-66: LGTM! Terminology update is consistent.

The change from "Teams SDK" to "Enterprise SDK" aligns with the rebranding effort.

Let's verify no other instances of "Teams" remain in this file:

docs/source/plugins/developing_plugins.rst (1)

1326-1328: LGTM! Terminology update matches PR objectives.

The reference to "FiftyOne Enterprise" is correctly updated from "Teams" to align with the rebranding effort.

docs/source/release-notes.rst (4)

Line range hint 6-24: LGTM! Clear and well-structured release notes for Enterprise 2.1.3

The release notes effectively communicate:

  • Version and release date
  • Inclusion of Community updates
  • Specific Enterprise changes

Line range hint 55-110: LGTM! Well-organized release notes for Enterprise 2.1.2

The release notes provide:

  • Clear version and release date
  • Comprehensive list of changes
  • Good organization by component (General, Admin, SDK)

903-915: LGTM! Concise release notes for Enterprise 1.5.7

The notes effectively communicate:

  • Version and release date
  • Inclusion of Community updates
  • Specific Enterprise improvements and bug fixes

Line range hint 2774-2807: LGTM! Clear historical release notes

The older release notes maintain consistent structure and detail level with newer releases.

such as API tokens and login credentials in a secure manner for use by your
:ref:`Team's plugins <teams-plugins>`.
:ref:`Team's plugins <enterprise-plugins>`.
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

Update remaining "Team's" reference to align with Enterprise branding

The text still contains "Team's plugins" which should be updated to "Enterprise plugins" for consistency with the rebranding effort.

-:ref:`Team's plugins <enterprise-plugins>`.
+:ref:`Enterprise plugins <enterprise-plugins>`.
📝 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
:ref:`Team's plugins <enterprise-plugins>`.
:ref:`Enterprise plugins <enterprise-plugins>`.

docs/source/enterprise/migrations.rst Outdated Show resolved Hide resolved
docs/source/enterprise/migrations.rst Outdated Show resolved Hide resolved
docs/source/conf.py Outdated Show resolved Hide resolved
docs/source/enterprise/roles_and_permissions.rst Outdated Show resolved Hide resolved
Comment on lines 200 to 210
:image_link: enterprise/installation.html#google-cloud-storage
:image_src: https://voxel51.com/images/integrations/google-cloud-128.png
:image_title: Google Cloud

.. customimagelink::
:image_link: teams/installation.html#amazon-s3
:image_link: enterprise/installation.html#amazon-s3
:image_src: https://voxel51.com/images/integrations/aws-128.png
:image_title: Amazon Web Services

.. customimagelink::
:image_link: teams/installation.html#microsoft-azure
:image_link: enterprise/installation.html#microsoft-azure
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Codebase verification

Remaining references to "teams" found in enterprise documentation

The following files still contain references to "teams" and should be updated to "enterprise":

  • docs/source/enterprise/installation.rst
  • docs/source/enterprise/cloud_media.rst
🔗 Analysis chain

Verify that the new enterprise documentation paths are accessible

The cloud storage integration links have been updated to point to the enterprise documentation. Let's verify that these new paths exist and are accessible.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Check if the new enterprise documentation paths exist
# Expected: Files should exist at these locations

# Search for the enterprise installation documentation files
fd --type f "installation.*" enterprise/

Length of output: 474

@@ -519,7 +519,7 @@ environments.
not recommended or officially supported. It is useful only for prototyping.

Our recommended, scalable approach to work with cloud-backed data is
:ref:`FiftyOne Teams <fiftyone-teams>`, an enterprise deployment of
:ref:`FiftyOne Enterprise <fiftyone-enterprise>`, an enterprise deployment of
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Codebase verification

Update remaining "Teams" references in the documentation to "Enterprise".

  • Found remaining occurrences in:
    • docs/source/enterprise/installation.rst
    • docs/source/enterprise/cloud_media.rst
🔗 Analysis chain

LGTM! Verify the cross-reference target exists.

The terminology change from "Teams" to "Enterprise" aligns with the PR objectives.

Let's verify that the referenced section exists with the new name to avoid broken links:

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Check if the Enterprise documentation section exists
# Expected: Find the target of the cross-reference to avoid broken links

# Search for the Enterprise section definition
rg "^\.\. _fiftyone-enterprise:" docs/

# Search for any remaining references to "Teams"
rg -i "teams" docs/ --type rst

Length of output: 579

Comment on lines 845 to 848
We recommend including Enterprise in your function’s `requirements.txt` file by
passing your token as a build environment variable, e.g.,
`FIFTYONE_TEAMS_TOKEN` and then using the syntax below to specify the version
of the Teams client to use:
of the Enterprise client to use:
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

Update environment variable name to match Enterprise branding

The environment variable FIFTYONE_TEAMS_TOKEN should be updated to FIFTYONE_ENTERPRISE_TOKEN to maintain consistency with the rebranding effort.

-`FIFTYONE_TEAMS_TOKEN` and then using the syntax below to specify the version
+`FIFTYONE_ENTERPRISE_TOKEN` and then using the syntax below to specify the version
📝 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
We recommend including Enterprise in your function’s `requirements.txt` file by
passing your token as a build environment variable, e.g.,
`FIFTYONE_TEAMS_TOKEN` and then using the syntax below to specify the version
of the Teams client to use:
of the Enterprise client to use:
We recommend including Enterprise in your function's `requirements.txt` file by
passing your token as a build environment variable, e.g.,
`FIFTYONE_ENTERPRISE_TOKEN` and then using the syntax below to specify the version
of the Enterprise client to use:

@swheaton
Copy link
Contributor

but if the second is too much this close to release, we can only keep the first commit so that at least the visible docs will be correct.

^^ this one

"colab": {
"base_uri": "https://localhost:8080/"
"collapsed_sections": [],
"name": "FiftyOne_Enterprise_View_Expressions.ipynb",
Copy link
Contributor

Choose a reason for hiding this comment

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

doesnt seem right

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I don't know what happened here. This file got heavily edited unintentionally based on the diff, I just restored it back to the base release branch

Copy link
Contributor

Choose a reason for hiding this comment

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

the .ipynb files might need to be manually inspected and edited tbh


FiftyOne Teams Overview
FiftyOne Enterprise Overview
=======================
Copy link
Contributor

@benjaminpkane benjaminpkane Nov 12, 2024

Choose a reason for hiding this comment

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

The line lengths for 3 and 4 need to match, I believe (a general note)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Good catch, thanks!

Copy link
Contributor

Choose a reason for hiding this comment

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

technically len(4) just has to be >= len(3)
but brian has liked it to be exactly equal idk.
but ya great catch. would be pretty apparent on doc build

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: 2

🧹 Outside diff range and nitpick comments (13)
docs/source/teams/api_connection.rst (1)

Update remaining "teams" references to "Enterprise" for consistency

The following files still reference "teams-api-connection":

  • docs/source/teams/installation.rst
  • docs/source/teams/management_sdk.rst
  • docs/source/teams/api_connection.rst
  • docs/source/release-notes.rst
  • docs/source/user_guide/config.rst

Ensure all references are updated to maintain consistency and prevent broken links.

🔗 Analysis chain

Line range hint 1-1: Consider updating file path and anchor names for consistency

While the content has been updated to use "Enterprise", the following still reference "teams":

  • File path: docs/source/teams/api_connection.rst
  • Anchor: teams-api-connection

This might cause confusion or break documentation links if not handled carefully.

Consider creating a comprehensive migration plan to:

  1. Update file paths
  2. Update anchor references
  3. Ensure proper redirects or compatibility layer for existing links

Also applies to: 9-9, 19-19

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check for any remaining references to these anchors in other documentation files
rg -l "teams-api-connection" --type rst

Length of output: 286


Script:

#!/bin/bash
# Check for any remaining references to "teams-api-connection" anchors in other documentation files
rg -l "teams-api-connection" --type rst

Length of output: 212

docs/source/teams/index.rst (2)

Line range hint 11-12: Update social links URLs to reflect Enterprise branding

The social links section contains outdated URLs that still reference "teams":

  • voxel51.com/fiftyone-teams should be updated to voxel51.com/fiftyone-enterprise
  • voxel51.com/schedule-teams-workshop should be updated to voxel51.com/schedule-enterprise-workshop

Also applies to: 17-18


Line range hint 144-149: Update toctree entries to use Enterprise terminology

The following toctree entries need to be updated:

  • teams_appenterprise_app
  • teams_pluginsenterprise_plugins

Ensure that the corresponding files are renamed accordingly.

docs/source/teams/migrations.rst (2)

8-11: Update internal reference names for consistency

The internal references still use the 'teams-' prefix (e.g., teams-upgrading, teams-upgrade-python-sdk). Consider updating these to use 'enterprise-' prefix for consistency with the rebranding effort.


Line range hint 136-175: Consider adding a note about data persistence

The migration instructions are clear and accurate. However, it might be helpful to add a note about data persistence and any potential downtime during the migration process.

Consider adding a note like:

.. note::

    During the migration process, ensure that no other processes are actively modifying 
    the dataset to maintain data consistency. The migration process is non-destructive 
    and your original dataset remains unchanged.
docs/source/index.rst (1)

Line range hint 480-493: Remove placeholder markers from new sections

The __SUB_NEW__ markers in the table of contents appear to be placeholders and should be removed.

Apply this diff to clean up the table of contents:

-   Dataset Zoo __SUB_NEW__ <dataset_zoo/index>
-   Model Zoo __SUB_NEW__ <model_zoo/index>
+   Dataset Zoo <dataset_zoo/index>
+   Model Zoo <model_zoo/index>
docs/source/teams/installation.rst (4)

Line range hint 27-76: Update remaining "teams" references in Python SDK section

The following items need to be updated:

  1. Reference anchor: :ref:teams-app``
  2. Image path: /images/teams/install_fiftyone.png

Line range hint 78-162: Update Poetry configuration to use Enterprise terminology

Several Poetry-related configurations still use "teams":

  1. Source name: fiftyone-teams
  2. Environment variables: POETRY_HTTP_BASIC_FIFTYONE_TEAMS_USERNAME
  3. Poetry add command: --source fiftyone-teams

Consider updating these to maintain consistency with the Enterprise branding.


Line range hint 163-632: Consider updating example URLs and anchors in cloud storage section

While the PR objectives mention keeping environment variables unchanged, consider updating:

  1. Example URLs: https://fiftyone-teams-deployment.yourcompany.com
  2. Reference anchors: teams-cloud-credentials, teams-cors, etc.

Note: As mentioned in the PR objectives, environment variables can remain unchanged for now pending further testing.


Multiple "teams" references found across documentation files

The rebranding from "Teams" to "Enterprise" is incomplete. The following files still reference "teams" and need to be updated:

  • docs/source/release-notes.rst
  • docs/source/teams/migrations.rst
  • docs/source/teams/teams_plugins.rst
  • docs/source/user_guide/config.rst
  • docs/source/teams/index.rst
  • docs/source/teams/api_connection.rst
  • docs/source/teams/dataset_versioning.rst
  • docs/source/teams/management_sdk.rst
  • docs/source/teams/cloud_media.rst
  • docs/source/plugins/developing_plugins.rst
  • docs/source/teams/secrets.rst
  • docs/source/teams/teams_app.rst
  • docs/source/teams/roles_and_permissions.rst
  • docs/source/teams/overview.rst

Please ensure all instances of "teams" are updated to "Enterprise" for consistency.

🔗 Analysis chain

Line range hint 1-24: Update file path and reference anchor for consistency

While the content has been updated to use "Enterprise", the following items still reference "teams":

  1. File path: docs/source/teams/installation.rst
  2. Reference anchor: .. _teams-installation:

Consider updating these for complete consistency with the rebranding effort.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check for other RST files that might reference this anchor
rg "teams-installation" --type rst

Length of output: 21250

docs/source/release-notes.rst (3)

Line range hint 6-10: Inconsistent release note formatting and version numbering

The release notes show inconsistencies in formatting and version numbering:

  1. Some version headers use dashes (e.g., "FiftyOne Enterprise 1.5.2") while others use dots (e.g., "FiftyOne Enterprise 1.5.10")
  2. The number of dashes used for RST section underlines varies between versions
  3. Some versions include explicit "News" or "General" sections while others directly list changes
  4. Some versions have "Bugs" sections while others mix bug fixes with features

Consider standardizing the format across all release notes for better readability.

-FiftyOne Enterprise 2.1.3
--------------------
+FiftyOne Enterprise 2.1.3
-------------------------

News
----

General
-------

Bugs
----

Also applies to: 55-61, 62-110, 217-324, 469-530, 531-531, 632-638, 641-656, 659-665, 796-803, 1008-1014, 1035-1047, 1154-1164, 1250-1261, 1261-1296, 1296-1340, 1782-1788, 1792-1929, 2112-2166, 2187-2207, 2296-2314, 2319-2322, 2776-2785, 2809-2840, 2850-2850, 3048-3057


531-531: Inconsistent indentation in text changes

The text changes at lines 531, 2319-2322, and 2850 have inconsistent indentation compared to surrounding content. This could affect RST rendering.

Also applies to: 2319-2322, 2850-2850


Line range hint 1261-1296: Duplicate version header

The version 1.5.1 header appears twice in the file (lines 1261 and 1296). This appears to be a copy-paste error.

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between d176ee9 and 3301e1d.

📒 Files selected for processing (25)
  • docs/README.md (1 hunks)
  • docs/generate_docs.bash (1 hunks)
  • docs/source/_templates/layout.html (2 hunks)
  • docs/source/cheat_sheets/fiftyone_terminology.rst (1 hunks)
  • docs/source/environments/index.rst (1 hunks)
  • docs/source/faq/index.rst (1 hunks)
  • docs/source/getting_started/install.rst (1 hunks)
  • docs/source/index.rst (1 hunks)
  • docs/source/plugins/developing_plugins.rst (1 hunks)
  • docs/source/plugins/using_plugins.rst (3 hunks)
  • docs/source/release-notes.rst (50 hunks)
  • docs/source/teams/api_connection.rst (4 hunks)
  • docs/source/teams/cloud_media.rst (5 hunks)
  • docs/source/teams/dataset_versioning.rst (16 hunks)
  • docs/source/teams/index.rst (6 hunks)
  • docs/source/teams/installation.rst (13 hunks)
  • docs/source/teams/management_sdk.rst (1 hunks)
  • docs/source/teams/migrations.rst (7 hunks)
  • docs/source/teams/overview.rst (3 hunks)
  • docs/source/teams/pluggable_auth.md (7 hunks)
  • docs/source/teams/roles_and_permissions.rst (4 hunks)
  • docs/source/teams/secrets.rst (2 hunks)
  • docs/source/teams/teams_app.rst (6 hunks)
  • docs/source/teams/teams_plugins.rst (16 hunks)
  • docs/source/user_guide/config.rst (1 hunks)
✅ Files skipped from review due to trivial changes (8)
  • docs/source/teams/cloud_media.rst
  • docs/source/teams/dataset_versioning.rst
  • docs/source/teams/management_sdk.rst
  • docs/source/teams/overview.rst
  • docs/source/teams/roles_and_permissions.rst
  • docs/source/teams/secrets.rst
  • docs/source/teams/teams_app.rst
  • docs/source/teams/teams_plugins.rst
🚧 Files skipped from review as they are similar to previous changes (9)
  • docs/README.md
  • docs/generate_docs.bash
  • docs/source/_templates/layout.html
  • docs/source/cheat_sheets/fiftyone_terminology.rst
  • docs/source/environments/index.rst
  • docs/source/faq/index.rst
  • docs/source/getting_started/install.rst
  • docs/source/plugins/using_plugins.rst
  • docs/source/user_guide/config.rst
🧰 Additional context used
🪛 LanguageTool
docs/source/teams/pluggable_auth.md

[uncategorized] ~34-~34: Possible missing comma found.
Context: ...ternal Mode In internal mode, FiftyOne Enterprise the CAS replaces Auth0. FiftyOne Enterp...

(AI_HYDRA_LEO_MISSING_COMMA)

🔇 Additional comments (12)
docs/source/teams/api_connection.rst (2)

33-33: LGTM! Environment variables maintained as planned

The configuration table updates correctly reflect the Enterprise terminology while maintaining the existing environment variables, which aligns with the PR objectives.

Also applies to: 35-35


65-65: Verify and update screenshot paths

The text refers to the "FiftyOne Enterprise App", but the image paths still use the "teams" prefix:

/images/teams/api_key_generate.png
/images/teams/api_key_generated.png
#!/bin/bash
# Check for image files and their locations
fd "api_key_.*\.png" docs/source/images/

Consider:

  1. Updating image paths to match the new terminology
  2. Verifying that the screenshots reflect the current Enterprise UI

Also applies to: 73-73, 79-79

docs/source/teams/index.rst (3)

35-42: LGTM! Description properly reflects Enterprise branding

The main description section has been correctly updated to use the new Enterprise terminology while maintaining clear and accurate content.


92-92: ⚠️ Potential issue

Update file paths in button links to use Enterprise terminology

Some button links still reference the old "teams" terminology:

  • teams_app.html should be updated to enterprise_app.html
  • teams_plugins.html should be updated to enterprise_plugins.html

Ensure that these files are also renamed as part of the rebranding effort.

Let's verify if these files exist and check for any references:

#!/bin/bash
# Check for the existence of both old and new filenames
fd -e html "teams_app|teams_plugins|enterprise_app|enterprise_plugins" docs/source

# Search for references to these files
rg -t rst "teams_app\.html|teams_plugins\.html" docs/source

Also applies to: 104-104


Line range hint 1-149: Consider relocating file to enterprise directory

This file is currently located in the docs/source/teams directory. For complete consistency with the rebranding effort, consider:

  1. Creating a new docs/source/enterprise directory
  2. Moving this file and related documentation to the new directory
  3. Updating all references to the documentation path

Let's check for other files that might need to be moved and references that need updating:

#!/bin/bash
# List all files in the teams directory
fd . docs/source/teams

# Search for references to the teams directory
rg -t rst -t py "teams/[^/]+" docs/source
docs/source/teams/migrations.rst (2)

Line range hint 106-133: LGTM: Downgrade instructions are clear and accurate

The downgrade section provides clear instructions with appropriate version references and necessary warnings.


36-38: Update anchor reference in note section

The note references :ref:account icon ``, but this anchor might need to be updated to maintain consistency with the Enterprise rebranding.

✅ Verification successful

Anchor reference teams-python-sdk is up-to-date and exists in the codebase.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check if the referenced anchor exists and if it needs updating
rg ".. _teams-python-sdk:" docs/source/

Length of output: 98

docs/source/index.rst (2)

Line range hint 1-493: Verify all "teams" references have been updated

Let's verify that all references to "teams" have been updated to "enterprise" throughout the documentation.


480-480: ⚠️ Potential issue

Update cloud storage integration links to use "enterprise" paths

The cloud storage integration links in the documentation still point to the old "teams" paths. These should be updated to maintain consistency with the rebranding.

Apply this diff to update the paths:

-   :image_link: teams/installation.html#google-cloud-storage
+   :image_link: enterprise/installation.html#google-cloud-storage

-   :image_link: teams/installation.html#amazon-s3
+   :image_link: enterprise/installation.html#amazon-s3

-   :image_link: teams/installation.html#microsoft-azure
+   :image_link: enterprise/installation.html#microsoft-azure

Likely invalid or redundant comment.

docs/source/teams/installation.rst (1)

Line range hint 1-632: Verify cross-references in other documentation files

The changes to reference anchors and file paths may affect other documentation files that link to this content.

#!/bin/bash
# Check for files that might be affected by anchor changes
echo "Checking for references to teams-installation anchor..."
rg "teams-installation" --type rst

echo "Checking for references to teams-cloud-credentials anchor..."
rg "teams-cloud-credentials" --type rst

echo "Checking for references to teams-cors anchor..."
rg "teams-cors" --type rst

# Check for other potential cross-references
echo "Checking for other potential cross-references..."
rg "teams-[a-zA-Z-]+" --type rst
docs/source/plugins/developing_plugins.rst (2)

Line range hint 1-1325: LGTM!

The rest of the documentation looks good and doesn't contain any references to "Teams" that need to be updated.

Also applies to: 1329-2024


1326-1328: ⚠️ Potential issue

Update "Teams" reference to "Enterprise"

This section still contains a reference to "FiftyOne Teams" that should be updated to "FiftyOne Enterprise" as part of the rebranding effort.

Apply this diff to update the terminology:

-    :ref:`FiftyOne Teams <fiftyone-teams>` users can view the current progress
+    :ref:`FiftyOne Enterprise <fiftyone-teams>` users can view the current progress

Likely invalid or redundant comment.

docs/source/teams/index.rst Show resolved Hide resolved
Comment on lines 1 to +4
.. _fiftyone-teams:

FiftyOne Teams
==============
FiftyOne Enterprise
===================
Copy link
Contributor

Choose a reason for hiding this comment

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

💡 Codebase verification

Update all references from fiftyone-teams to fiftyone-enterprise

Multiple references to fiftyone-teams were found in the following files. Please update them to fiftyone-enterprise to ensure consistency with the new branding:

  • docs/source/release-notes.rst
  • docs/source/index.rst
  • docs/source/conf.py
  • docs/source/cheat_sheets/fiftyone_terminology.rst
  • docs/source/teams/index.rst
  • (additional files as necessary)
🔗 Analysis chain

Update the anchor tag to match Enterprise branding

The anchor tag _fiftyone-teams should be updated to _fiftyone-enterprise for consistency with the new branding.

Let's verify existing references to this anchor before making the change:

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Search for references to the teams anchor tag in RST files
rg -t rst ":ref:\`.*fiftyone-teams.*\`" 

Length of output: 6635

@brimoor brimoor changed the title Update Docs for Fiftyone Enterprise [HOLD] Update Docs for Fiftyone Enterprise Nov 13, 2024
Copy link
Contributor

@brimoor brimoor left a comment

Choose a reason for hiding this comment

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

Please hold off on merging this for now per offline discussion 🙇

@swheaton swheaton marked this pull request as draft November 13, 2024 16:00
Base automatically changed from release/v1.1.0 to main December 6, 2024 15:31
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.

4 participants