Rename availability labels to Shared for (#1257)

prokopetsv · web-flow · commit 2f28f1d94d3e · 2026-05-29T19:25:48.000+03:00
diff --git a/.changeset/availability-shared-for-rename.md b/.changeset/availability-shared-for-rename.md
@@ -0,0 +1,7 @@
+---
+'owox': minor
+---
+
+# Availability labels renamed to "Shared for use / reporting / maintenance"
+
+The availability toggle labels throughout the product have been renamed from "Available for use", "Available for reporting", and "Available for maintenance" to "Shared for use", "Shared for reporting", and "Shared for maintenance". The filter option previously labelled "Not available" is now "Not shared". This change makes the language more consistent and better reflects the collaborative sharing intent behind the toggles.
diff --git a/apps/web/e2e/specs/availability.spec.ts b/apps/web/e2e/specs/availability.spec.ts
@@ -15,8 +15,8 @@ async function ensureSectionExpanded(container: Locator, sectionName: string): P
 /**
  * Get the two availability switches within a container.
  * Returns [primarySwitch, maintenanceSwitch] — the first switch is
- * "Available for use" (storage/destination) or "Available for reporting" (data-mart),
- * the second is always "Available for maintenance".
+ * "Shared for use" (storage/destination) or "Shared for reporting" (data-mart),
+ * the second is always "Shared for maintenance".
  */
 function getAvailabilitySwitches(container: Locator | Page): [Locator, Locator] {
   const switches = container.getByRole('switch');
@@ -46,8 +46,8 @@ test.describe('Storage Availability', () => {
     await ensureSectionExpanded(sheet, 'Availability');
 
     // Both labels should be visible
-    await expect(sheet.getByText('Available for use', { exact: true })).toBeVisible();
-    await expect(sheet.getByText('Available for maintenance', { exact: true })).toBeVisible();
+    await expect(sheet.getByText('Shared for use', { exact: true })).toBeVisible();
+    await expect(sheet.getByText('Shared for maintenance', { exact: true })).toBeVisible();
   });
 
   test('availability defaults to use=ON, maintenance=OFF for new storage (AVL-02)', async ({
@@ -76,7 +76,7 @@ test.describe('Storage Availability', () => {
 
   test('availability set via API is reflected in UI (AVL-03)', async ({ page, apiHelpers }) => {
     const storage = await apiHelpers.createStorage('GOOGLE_BIGQUERY');
-    // Set "Available for maintenance" to OFF via API
+    // Set "Shared for maintenance" to OFF via API
     await apiHelpers.setStorageAvailability(storage.id, true, false);
 
     await page.goto('/ui/0/data-storages');
@@ -92,7 +92,7 @@ test.describe('Storage Availability', () => {
     // Expand Availability section
     await ensureSectionExpanded(sheet, 'Availability');
 
-    // "Available for use" should be ON, "Available for maintenance" should be OFF
+    // "Shared for use" should be ON, "Shared for maintenance" should be OFF
     const [useSwitch, maintenanceSwitch] = getAvailabilitySwitches(sheet);
     await expect(useSwitch).toHaveAttribute('data-state', 'checked');
     await expect(maintenanceSwitch).toHaveAttribute('data-state', 'unchecked');
@@ -116,16 +116,16 @@ test.describe('Destination Availability', () => {
     // Expand Availability section
     await ensureSectionExpanded(sheet, 'Availability');
 
-    await expect(sheet.getByText('Available for use', { exact: true })).toBeVisible();
-    await expect(sheet.getByText('Available for maintenance', { exact: true })).toBeVisible();
+    await expect(sheet.getByText('Shared for use', { exact: true })).toBeVisible();
+    await expect(sheet.getByText('Shared for maintenance', { exact: true })).toBeVisible();
   });
 
   test('destination availability set via API is reflected in UI (AVL-05)', async ({
     page,
     apiHelpers,
   }) => {
     const dest = await apiHelpers.createDestination('LOOKER_STUDIO', 'Persist Dest');
-    // Set "Available for use" to OFF via API
+    // Set "Shared for use" to OFF via API
     await apiHelpers.setDestinationAvailability(dest.id, false, true);
 
     await page.goto('/ui/0/data-destinations');
@@ -139,7 +139,7 @@ test.describe('Destination Availability', () => {
     // Expand Availability section
     await ensureSectionExpanded(sheet, 'Availability');
 
-    // "Available for use" should be OFF, "Available for maintenance" should be ON
+    // "Shared for use" should be OFF, "Shared for maintenance" should be ON
     const [useSwitch, maintenanceSwitch] = getAvailabilitySwitches(sheet);
     await expect(useSwitch).toHaveAttribute('data-state', 'unchecked');
     await expect(maintenanceSwitch).toHaveAttribute('data-state', 'checked');
@@ -161,8 +161,8 @@ test.describe('DataMart Availability', () => {
     await expect(page.getByTestId(TESTIDS.datamartTabOverview)).toBeVisible();
 
     await expect(page.getByText('Availability')).toBeVisible();
-    await expect(page.getByText('Available for reporting', { exact: true })).toBeVisible();
-    await expect(page.getByText('Available for maintenance', { exact: true })).toBeVisible();
+    await expect(page.getByText('Shared for reporting', { exact: true })).toBeVisible();
+    await expect(page.getByText('Shared for maintenance', { exact: true })).toBeVisible();
   });
 
   test('DM availability toggle saves immediately without Save button (AVL-07)', async ({
@@ -176,7 +176,7 @@ test.describe('DataMart Availability', () => {
     await page.goto(`/ui/0/data-marts/${dm.id}/overview`);
     await expect(page.getByTestId(TESTIDS.datamartTabOverview)).toBeVisible();
 
-    // Toggle "Available for reporting" OFF (first switch)
+    // Toggle "Shared for reporting" OFF (first switch)
     const [reportingSwitch] = getAvailabilitySwitches(page);
     await reportingSwitch.click();
 
@@ -192,7 +192,7 @@ test.describe('DataMart Availability', () => {
     await page.goto(`/ui/0/data-marts/${dm.id}/overview`);
     await expect(page.getByTestId(TESTIDS.datamartTabOverview)).toBeVisible();
 
-    // Toggle "Available for maintenance" OFF (second switch)
+    // Toggle "Shared for maintenance" OFF (second switch)
     const [, maintenanceSwitch] = getAvailabilitySwitches(page);
     await maintenanceSwitch.click();
     await expect(page.getByText('Availability updated')).toBeVisible();
@@ -201,11 +201,11 @@ test.describe('DataMart Availability', () => {
     await page.reload();
     await expect(page.getByTestId(TESTIDS.datamartTabOverview)).toBeVisible();
 
-    // "Available for maintenance" should be OFF after reload
+    // "Shared for maintenance" should be OFF after reload
     const [reportingSwitchAfter, maintenanceSwitchAfter] = getAvailabilitySwitches(page);
     await expect(maintenanceSwitchAfter).toHaveAttribute('data-state', 'unchecked');
 
-    // "Available for reporting" should still be ON
+    // "Shared for reporting" should still be ON
     await expect(reportingSwitchAfter).toHaveAttribute('data-state', 'checked');
   });
 });
diff --git a/apps/web/src/features/data-destination/edit/components/DataDestinationEditForm/DataDestinationForm.tsx b/apps/web/src/features/data-destination/edit/components/DataDestinationEditForm/DataDestinationForm.tsx
@@ -335,7 +335,7 @@ export function DataDestinationForm({
             <FormSection title='Availability' defaultOpen={false} name='destination-availability'>
               <FormItem>
                 <div className='flex items-center justify-between gap-4'>
-                  <FormLabel>Available for use</FormLabel>
+                  <FormLabel>Shared for use</FormLabel>
                   <Switch
                     checked={sharingState.availableForUse}
                     onCheckedChange={v => {
@@ -349,7 +349,7 @@ export function DataDestinationForm({
                 <FormDescription>
                   <Accordion variant='common' type='single' collapsible>
                     <AccordionItem value='sharing-use-help'>
-                      <AccordionTrigger>What does "Available for use" mean?</AccordionTrigger>
+                      <AccordionTrigger>What does "Shared for use" mean?</AccordionTrigger>
                       <AccordionContent>
                         <p>
                           When enabled, project members can select this destination when configuring
@@ -362,7 +362,7 @@ export function DataDestinationForm({
               </FormItem>
               <FormItem>
                 <div className='flex items-center justify-between gap-4'>
-                  <FormLabel>Available for maintenance</FormLabel>
+                  <FormLabel>Shared for maintenance</FormLabel>
                   <Switch
                     checked={sharingState.availableForMaintenance}
                     onCheckedChange={v => {
@@ -377,9 +377,7 @@ export function DataDestinationForm({
                 <FormDescription>
                   <Accordion variant='common' type='single' collapsible>
                     <AccordionItem value='sharing-maintenance-help'>
-                      <AccordionTrigger>
-                        What does "Available for maintenance" mean?
-                      </AccordionTrigger>
+                      <AccordionTrigger>What does "Shared for maintenance" mean?</AccordionTrigger>
                       <AccordionContent>
                         <p>
                           When enabled, project members can copy credentials from this destination,
diff --git a/apps/web/src/features/data-marts/list/components/DataMartTable/columns/columnLabels.ts b/apps/web/src/features/data-marts/list/components/DataMartTable/columns/columnLabels.ts
@@ -13,6 +13,6 @@ export const dataMartColumnLabels: Record<DataMartColumnKey, string> = {
   [DataMartColumnKey.BUSINESS_OWNERS]: 'Business Owner',
   [DataMartColumnKey.TECHNICAL_OWNERS]: 'Technical Owner',
   [DataMartColumnKey.CONTEXTS]: 'Contexts',
-  [DataMartColumnKey.AVAILABLE_FOR_REPORTING]: 'Available for reporting',
-  [DataMartColumnKey.AVAILABLE_FOR_MAINTENANCE]: 'Available for maintenance',
+  [DataMartColumnKey.AVAILABLE_FOR_REPORTING]: 'Shared for reporting',
+  [DataMartColumnKey.AVAILABLE_FOR_MAINTENANCE]: 'Shared for maintenance',
 };
diff --git a/apps/web/src/features/data-marts/list/components/DataMartTable/columns/columns.tsx b/apps/web/src/features/data-marts/list/components/DataMartTable/columns/columns.tsx
@@ -296,7 +296,7 @@ export const getDataMartColumns = ({
     ),
     cell: ({ row }) =>
       row.original.availableForReporting === true ? (
-        <Check className='text-muted-foreground h-4 w-4' aria-label='Available for reporting' />
+        <Check className='text-muted-foreground h-4 w-4' aria-label='Shared for reporting' />
       ) : (
         <div className='text-muted-foreground'>—</div>
       ),
@@ -317,7 +317,7 @@ export const getDataMartColumns = ({
     ),
     cell: ({ row }) =>
       row.original.availableForMaintenance === true ? (
-        <Check className='text-muted-foreground h-4 w-4' aria-label='Available for maintenance' />
+        <Check className='text-muted-foreground h-4 w-4' aria-label='Shared for maintenance' />
       ) : (
         <div className='text-muted-foreground'>—</div>
       ),
diff --git a/apps/web/src/features/data-marts/list/components/DataMartTable/components/DataMartsTableFilters.config.ts b/apps/web/src/features/data-marts/list/components/DataMartTable/components/DataMartsTableFilters.config.ts
@@ -274,10 +274,10 @@ export function buildDataMartsTableFilters(
     },
     buildAvailabilityFilter<DataMartFilterKey>({
       id: AdditionalFilterKeys.AVAILABILITY,
-      firstLabel: 'Available for reporting',
-      maintenanceLabel: 'Available for maintenance',
-      bothLabel: 'Available for reporting and maintenance',
-      noneLabel: 'Not available',
+      firstLabel: 'Shared for reporting',
+      maintenanceLabel: 'Shared for maintenance',
+      bothLabel: 'Shared for reporting and maintenance',
+      noneLabel: 'Not shared',
     }),
   ];
 }
diff --git a/apps/web/src/features/data-storage/edit/components/DataStorageEditForm/DataStorageForm.tsx b/apps/web/src/features/data-storage/edit/components/DataStorageEditForm/DataStorageForm.tsx
@@ -401,7 +401,7 @@ export function DataStorageForm({
             <FormSection title='Availability' defaultOpen={false} name='storage-availability'>
               <FormItem>
                 <div className='flex items-center justify-between gap-4'>
-                  <FormLabel>Available for use</FormLabel>
+                  <FormLabel>Shared for use</FormLabel>
                   <Switch
                     checked={sharingState.availableForUse}
                     onCheckedChange={v => {
@@ -416,7 +416,7 @@ export function DataStorageForm({
                   <Accordion variant='common' type='single' collapsible>
                     <AccordionItem value='sharing-use-help'>
                       <AccordionTrigger>
-                        What does &quot;Available for use&quot; mean?
+                        What does &quot;Shared for use&quot; mean?
                       </AccordionTrigger>
                       <AccordionContent>
                         <p>
@@ -431,7 +431,7 @@ export function DataStorageForm({
               </FormItem>
               <FormItem>
                 <div className='flex items-center justify-between gap-4'>
-                  <FormLabel>Available for maintenance</FormLabel>
+                  <FormLabel>Shared for maintenance</FormLabel>
                   <Switch
                     checked={sharingState.availableForMaintenance}
                     onCheckedChange={v => {
@@ -446,7 +446,7 @@ export function DataStorageForm({
                   <Accordion variant='common' type='single' collapsible>
                     <AccordionItem value='sharing-maintenance-help'>
                       <AccordionTrigger>
-                        What does &quot;Available for maintenance&quot; mean?
+                        What does &quot;Shared for maintenance&quot; mean?
                       </AccordionTrigger>
                       <AccordionContent>
                         <p>
diff --git a/apps/web/src/features/project-settings/members/components/MemberDetailsSheet/MemberDetailsSheet.tsx b/apps/web/src/features/project-settings/members/components/MemberDetailsSheet/MemberDetailsSheet.tsx
@@ -223,11 +223,11 @@ export function MemberDetailsSheet({
                               <AccordionContent>
                                 <p className='mb-2'>
                                   <strong>Business User</strong> — sees accessible Data Marts and
-                                  Reports, creates Reports for Data Marts available for reporting,
+                                  Reports, creates Reports for Data Marts shared for reporting,
                                   manages Reports they own (edit, delete, change owners), manages
-                                  Report Triggers under their Reports, and uses Destinations
-                                  available for use. Cannot create, edit, or delete Data Marts, Data
-                                  Mart Triggers, or Storages.
+                                  Report Triggers under their Reports, and uses Destinations shared
+                                  for use. Cannot create, edit, or delete Data Marts, Data Mart
+                                  Triggers, or Storages.
                                 </p>
                                 <p className='mb-2'>
                                   <strong>Technical User</strong> — everything a Business User may
diff --git a/apps/web/src/features/project-settings/members/components/MemberFormFields/MemberFormFields.tsx b/apps/web/src/features/project-settings/members/components/MemberFormFields/MemberFormFields.tsx
@@ -98,9 +98,9 @@ export function MemberFormFields({
                     <AccordionContent>
                       <p className='mb-2'>
                         <strong>Business User</strong> — sees accessible Data Marts and Reports,
-                        creates Reports for Data Marts available for reporting, manages Reports they
+                        creates Reports for Data Marts shared for reporting, manages Reports they
                         own (edit, delete, change owners), manages Report Triggers under their
-                        Reports, and uses Destinations available for use. Cannot create, edit, or
+                        Reports, and uses Destinations shared for use. Cannot create, edit, or
                         delete Data Marts, Data Mart Triggers, or Storages.
                       </p>
                       <p className='mb-2'>
diff --git a/apps/web/src/pages/data-marts/edit/DataMartOverviewContent.tsx b/apps/web/src/pages/data-marts/edit/DataMartOverviewContent.tsx
@@ -276,7 +276,7 @@ export default function DataMartOverviewContent() {
                   htmlFor='available-for-maintenance'
                   className='text-foreground cursor-pointer text-sm font-medium select-none'
                 >
-                  Available for maintenance
+                  Shared for maintenance
                 </label>
               </div>
               <p className='text-muted-foreground text-xs'>
@@ -285,7 +285,7 @@ export default function DataMartOverviewContent() {
               <Accordion variant='common' type='single' collapsible>
                 <AccordionItem value='maintenance-help'>
                   <AccordionTrigger>
-                    What does &quot;Available for maintenance&quot; mean?
+                    What does &quot;Shared for maintenance&quot; mean?
                   </AccordionTrigger>
                   <AccordionContent>
                     <p>
@@ -311,7 +311,7 @@ export default function DataMartOverviewContent() {
                   htmlFor='available-for-reporting'
                   className='text-foreground cursor-pointer text-sm font-medium select-none'
                 >
-                  Available for reporting
+                  Shared for reporting
                 </label>
               </div>
               <p className='text-muted-foreground text-xs'>
@@ -320,7 +320,7 @@ export default function DataMartOverviewContent() {
               <Accordion variant='common' type='single' collapsible>
                 <AccordionItem value='reporting-help'>
                   <AccordionTrigger>
-                    What does &quot;Available for reporting&quot; mean?
+                    What does &quot;Shared for reporting&quot; mean?
                   </AccordionTrigger>
                   <AccordionContent>
                     <p>
diff --git a/apps/web/src/shared/components/AvailabilitySheet/AvailabilitySheet.tsx b/apps/web/src/shared/components/AvailabilitySheet/AvailabilitySheet.tsx
@@ -49,18 +49,18 @@ function getAvailabilityFields(
       {
         key: 'availableForReporting',
         sectionTitle: 'Reporting',
-        label: 'Available for reporting',
+        label: 'Shared for reporting',
         description: 'All project members can see this Data Mart and build reports on it',
-        helpTitle: 'What does "Available for reporting" mean?',
+        helpTitle: 'What does "Shared for reporting" mean?',
         helpContent:
           'When enabled, all project members (both Technical and Business Users) can see this Data Mart in the catalog and use it to create reports. Owners always have access regardless of this setting. Disable this to restrict visibility to owners only.',
       },
       {
         key: 'availableForMaintenance',
         sectionTitle: 'Maintenance',
-        label: 'Available for maintenance',
+        label: 'Shared for maintenance',
         description: 'Technical users can edit, delete, and manage triggers for this Data Mart',
-        helpTitle: 'What does "Available for maintenance" mean?',
+        helpTitle: 'What does "Shared for maintenance" mean?',
         helpContent:
           'When enabled, Technical Users who are not owners can edit the Data Mart definition, delete it, and manage its scheduled triggers. Business Users are not affected by this setting — they cannot perform maintenance actions regardless. Use this when you want other Technical Users on your team to help manage this Data Mart.',
       },
@@ -73,12 +73,12 @@ function getAvailabilityFields(
     {
       key: 'availableForUse',
       sectionTitle: 'Usage',
-      label: 'Available for use',
+      label: 'Shared for use',
       description:
         entityType === 'storage'
           ? 'Technical users can use this storage when creating Data Marts'
           : 'Project members can use this destination in their reports',
-      helpTitle: `What does "Available for use" mean?`,
+      helpTitle: `What does "Shared for use" mean?`,
       helpContent:
         entityType === 'storage'
           ? 'When enabled, Technical Users who are not owners can select this storage when creating new Data Marts. Without this, only storage owners and admins can use it. Enable this when multiple team members need to build Data Marts on the same storage.'
@@ -87,9 +87,9 @@ function getAvailabilityFields(
     {
       key: 'availableForMaintenance',
       sectionTitle: 'Maintenance',
-      label: 'Available for maintenance',
+      label: 'Shared for maintenance',
       description: `Project members with access can copy credentials, edit, and delete this ${entityName}`,
-      helpTitle: 'What does "Available for maintenance" mean?',
+      helpTitle: 'What does "Shared for maintenance" mean?',
       helpContent: `When enabled, project members can copy credentials from this ${entityName}, edit its configuration, and delete it. This is useful when multiple team members need to manage shared infrastructure. Without this, only owners and admins can perform these actions.`,
     },
   ];
diff --git a/apps/web/src/shared/components/TableFilters/availability-filter.utils.ts b/apps/web/src/shared/components/TableFilters/availability-filter.utils.ts
diff --git a/docs/project/contexts.md b/docs/project/contexts.md
diff --git a/docs/project/ownership-and-availability.md b/docs/project/ownership-and-availability.md
diff --git a/docs/project/roles-and-permissions.md b/docs/project/roles-and-permissions.md
