Skip to content

Add default application team setting section#3892

Merged
bennyyang11 merged 3 commits intomainfrom
bennyyang/docs-default-app-team-setting
Mar 18, 2026
Merged

Add default application team setting section#3892
bennyyang11 merged 3 commits intomainfrom
bennyyang/docs-default-app-team-setting

Conversation

@bennyyang11
Copy link
Copy Markdown
Member

Summary

  • Add "Set a default application" section to team-management.md
  • Documents the new Team Settings page where admins can configure which app new team members land on by default
  • Covers app selection priority chain, setup/clear steps, RBAC permissions, and API endpoint

Related

@bennyyang11 bennyyang11 requested a review from a team as a code owner March 18, 2026 18:07
@netlify
Copy link
Copy Markdown

netlify Bot commented Mar 18, 2026

Deploy Preview for replicated-docs ready!

Name Link
🔨 Latest commit 3ec62ea
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs/deploys/69baee4055bf35000870bcdb
😎 Deploy Preview https://deploy-preview-3892--replicated-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@netlify
Copy link
Copy Markdown

netlify Bot commented Mar 18, 2026

Deploy Preview for replicated-docs-upgrade ready!

Name Link
🔨 Latest commit 3ec62ea
🔍 Latest deploy log https://app.netlify.com/projects/replicated-docs-upgrade/deploys/69baee40bfb242000860c04a
😎 Deploy Preview https://deploy-preview-3892--replicated-docs-upgrade.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@replicated-ci replicated-ci added the type::docs Improvements or additions to documentation label Mar 18, 2026
Comment thread docs/vendor/team-management.md Outdated

## Set a default application

Teams with multiple applications can set a default application so that new team members, or anyone without browser history, land on the correct application when they first log in. Without a default, the Vendor Portal selects whichever application comes first alphabetically.
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.

📝 [vale] reported by reviewdog 🐶
[Replicated.SentenceLength] Try to keep your sentence length to 26 words or fewer.

Comment thread docs/vendor/team-management.md Outdated

1. **URL slug**: Direct links to a specific application always take priority.
1. **Browser local storage**: If you previously selected an application, the Vendor Portal remembers your last choice.
1. **Team default application**: The admin-configured default is used when there is no URL slug or browser history.
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.

📝 [vale] reported by reviewdog 🐶
[Replicated.Passive] In general, use active voice instead of passive voice ('is used').

Comment thread docs/vendor/team-management.md Outdated
1. **URL slug**: Direct links to a specific application always take priority.
1. **Browser local storage**: If you previously selected an application, the Vendor Portal remembers your last choice.
1. **Team default application**: The admin-configured default is used when there is no URL slug or browser history.
1. **Alphabetical**: If none of the above apply, the first application alphabetically is used.
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.

⚠️ [vale] reported by reviewdog 🐶
[Replicated.PositionalLanguage] Avoid spacial and directional language like 'above'. Instead, use 'on this page', 'the following', or link to the section.

Comment thread docs/vendor/team-management.md Outdated
1. **URL slug**: Direct links to a specific application always take priority.
1. **Browser local storage**: If you previously selected an application, the Vendor Portal remembers your last choice.
1. **Team default application**: The admin-configured default is used when there is no URL slug or browser history.
1. **Alphabetical**: If none of the above apply, the first application alphabetically is used.
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.

📝 [vale] reported by reviewdog 🐶
[Replicated.Passive] In general, use active voice instead of passive voice ('is used').

Comment thread docs/vendor/team-management.md Outdated

To set a default application:

1. From the Team Members page, click **Team Settings** from the left navigation.
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.

⚠️ [vale] reported by reviewdog 🐶
[Replicated.PositionalLanguage] Avoid spacial and directional language like 'left'. Instead, use 'on this page', 'the following', or link to the section.

Comment thread docs/vendor/team-management.md Outdated

1. Click **Save changes**.

To clear the default, click **Clear default** on the Team Settings page. When the default is cleared, the Vendor Portal falls back to alphabetical ordering.
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.

📝 [vale] reported by reviewdog 🐶
[Replicated.Passive] In general, use active voice instead of passive voice ('is cleared').

Copy link
Copy Markdown
Contributor

@paigecalvert paigecalvert left a comment

Choose a reason for hiding this comment

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

thanks @bennyyang11 !

I moved this to the Manage applications page rather than team management.

I also removed some of the detailed info about how the vendor portal decides which app to show (users probably don't need all the context).

For the API docs, we can link to the API doc when one exists (something like "For information about how to set or clear a default application from the Vendor API, see /v3/team/default-app in the Vendor API documentation"). (I checked the API docs but didn't think I saw any docs for default-app yet https://replicated-vendor-api.readme.io/reference/createapp)

@bennyyang11 bennyyang11 merged commit 546437a into main Mar 18, 2026
5 checks passed
@bennyyang11 bennyyang11 deleted the bennyyang/docs-default-app-team-setting branch March 18, 2026 18:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

type::docs Improvements or additions to documentation type::feature

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants