Merge branch 'main' into PORT-16638-Fix-Default-Mapping-For-GitHub-Ocean

Author: dennis-bilson-port

docs/build-your-software-catalog/sync-data-to-catalog/kubernetes-stack/kubernetes/kubernetes.md

@@ -68,16 +68,20 @@ Not sure which method is right for your use case? Check the available [installat
 
 <TabItem value="helm" label="Helm" default>
 
-<OceanRealtimeInstallation integration="Kubernetes" />
+To install the integration using Helm:
 
-<PortApiRegionTip/>
+1. Go to the Kubernetes [data sources page](https://app.getport.io/settings/data-sources?section=EXPORTERS&provider=Kubernetes) in your portal.
+
+    <img src="/img/sync-data-to-catalog/kubernetesIntegrationPage.png" width="70%" border='1px' />
+
+2. A `helm` command will be displayed, with default values already filled out (e.g. your Port client ID, client secret). Copy the command then run it in your terminal to install the integration.
 
 </TabItem>
 
 <TabItem value="argo" label="ArgoCD">
 
 1. Install the `my-port-k8s-exporter` ArgoCD Application by creating the following `my-port-k8s-exporter.yaml` manifest:
-    :::note
+    :::note Configuration requirements
     Remember to replace the placeholders for `LATEST_HELM_RELEASE` `YOUR_PORT_CLIENT_ID` `YOUR_PORT_CLIENT_SECRET` and `YOUR_GIT_REPO_URL`.
 
     You can find the latest version `port-k8s-exporter` chart in our [Releases](https://github.com/port-labs/helm-charts/releases?q=port-k8s-exporter&expanded=true) page.
@@ -86,7 +90,7 @@ Not sure which method is right for your use case? Check the available [installat
     :::
 
     <details>
-      <summary>ArgoCD Application</summary>
+      <summary><b>ArgoCD Application (click to expand)</b></summary>
 
     ```yaml showLineNumbers
     apiVersion: argoproj.io/v1alpha1

docs/customize-pages-dashboards-and-plugins/page/catalog-page.md

@@ -183,16 +183,24 @@ The description will be displayed at the top of the page, under the page title:
 
 <img src='/img/software-catalog/pages/catalogPageDescription.png' width='80%' border='1px' />
 
+## Performance
+
+Large entity tables can result in long loading times. Use the following tips and best practices to improve performance.
+
+The [initial filters](#initial-filters) and [excluded properties](#excluded-properties) are defined when creating the page, while [calculation properties](#calculation-properties) are configured as part of the blueprint definition.
+
 ### Initial filters
 
-In some cases, an entities table may be very large, resulting in long loading times. To prevent this, you can define filters that resolve when Port queries the data (rather than after querying).  
+Initial filters are the most effective way to reduce loading times. You can define filters that resolve when Port queries the data (rather than after querying, like table filters), reducing the number of entities displayed in the table.
+
 To define such a filter, use the `Initial filters` field when creating a page:
 
 <img src='/img/software-catalog/pages/initialFiltersForm.png' width='50%' border='1px' />
 
 <br/><br/>
 
-You can define any [supported rule](/search-and-query/#rules) in JSON format. Here is an example that will only display `Deployments` that were updated in the past month:
+You can define any [supported rule](/search-and-query/#rules) in JSON format.  
+Here is an example that will only display `Deployments` that were updated in the past month:
 
 ```json showLineNumbers
 [
@@ -211,10 +219,19 @@ You can use [dynamic properties](/search-and-query/#dynamic-properties) of the l
 ### Excluded properties
 
 Another way to reduce loading times is to exclude undesired properties from an entities table when querying the data. When using this option, the new table will not contain columns for the excluded properties.  
+
+We recommend excluding properties with no actual benefit when shown in the table, such as large object properties, long array properties, and other complex data types.
+
 To do this, use the `Excluded properties` field when creating a page:
 
 <img src='/img/software-catalog/pages/excludePropertiesForm.png' width='50%'  border='1px' />
 
+### Calculation properties
+
+While calculation properties provide powerful functionality, they can impact performance when used in blueprints that have many entities. To improve performance, consider excluding calculation properties from the table or replacing them with regular properties.
+
+To learn more about calculation properties performance, refer to the [calculation property](/build-your-software-catalog/customize-integrations/configure-data-model/setup-blueprint/properties/calculation-property/#performance-impact) page.
+
 ## Customization
 
 The entities table can be customized, which will define the users' view of the Port platform.

docs/sso-rbac/multi-organization.md

@@ -38,8 +38,12 @@ In order to switch to a different organization:
 2. Click on the logo in the top left corner of the page.
 3. Click on the organization you want to switch to.
 
-:::info Login behavior
-Note that when users log in, they automatically access their **last visited** organization.
+:::caution Login behavior and organization switching
+When users log in, they automatically access their **last visited** organization.
+
+If you have active sessions in multiple tabs or browsers, switching organizations in one session will switch all other active sessions to that same organization.
+
+We recommend you verify the active organization before making changes.
 :::
 
 ## Automatic user access