Merge branch 'main' into PORT-16636

Author: mk-armah

CONTRIBUTING.md renamed to best_practices.md

@@ -1,14 +1,6 @@
-# Contributing to Port's documentation
+# Port documentation style guide
 
-Here you can find resources and guidelines on how to contribute to Port's documentation and how to correctly write and fix documentation content.
-
-## How to contribute
-
-The best way to suggest edits for an existing page is by using the "Edit this page" button at the bottom of most docs, this button will take you to the GitHub interface to make and propose changes.
-
-If you want to add a new documentation page, please fork the repository and after adding the new docs, create a PR which will be reviewed by our team.
-
-Contributions are very welcome. If you need help planning your contribution, feel free to ask us by opening an issue in this repository or by writing in our [community Slack](https://join.slack.com/t/getport/shared_invite/zt-1v5z1z1v-3~1Q1Q1).
+This document details guidelines for contributing to Port's documentation, and demonstrates how to correctly write and review documentation content.
 
 ## Styling guidelines
 

docs/ai-interfaces/ai-chat-widget.md

@@ -9,9 +9,9 @@ import TabItem from "@theme/TabItem"
 
 # AI Chat Widget
 
-:::info Closed Beta
-Port's AI offerings are currently in closed beta and will be gradually rolled out to users by the end of 2025.
-:::
+import BetaFeatureNotice from '/docs/generalTemplates/_beta_feature_notice.md'
+
+<BetaFeatureNotice id="ai-form" />
 
 The AI Chat Widget provides a customizable interface for interacting with [Port AI](/ai-interfaces/port-ai/overview) directly within your dashboards. Platform engineers can configure the widget's prompts, conversation starters, and available developer tools to create tailored AI chat experiences for developers.
 

docs/ai-interfaces/context-lake.md

@@ -9,6 +9,10 @@ import TabItem from "@theme/TabItem"
 
 # Context lake
 
+import BetaFeatureNotice from '/docs/generalTemplates/_beta_feature_notice.md'
+
+<BetaFeatureNotice id="ai-form" />
+
 Port's Context Lake is your unified engineering knowledge layer—connecting data from across your entire toolchain into a single, semantically-rich source of truth. It's not a separate feature, but rather the powerful result of Port's core capabilities working together to provide organizational context that AI agents, developers, and workflows can understand and act upon.
 
 ## What comprises the context lake

docs/ai-interfaces/overview.md

@@ -5,7 +5,7 @@ title: Overview
 
 # AI Interfaces Overview
 
-Port's AI interfaces provide intelligent assistance across your entire software development lifecycle. Our AI capabilities are currently in **open beta**, with AI Agents in **closed beta**.
+Port's AI interfaces provide intelligent assistance across your entire software development lifecycle. Our AI capabilities are currently in **open beta**, with Slack App in **closed beta**.
 
 We're committed to developing AI responsibly, maintaining high standards of data privacy and security. **[Learn more about our security & data controls →](/ai-interfaces/port-ai/security-and-data-controls)**
 
@@ -19,9 +19,9 @@ This organizational intelligence enables AI to provide accurate answers about wh
 
 ## Port's AI Offerings
 
-:::info Closed Beta
-Port's AI offerings are currently in closed beta and will be gradually rolled out to users by the end of 2025.
-:::
+import BetaFeatureNotice from '/docs/generalTemplates/_beta_feature_notice.md'
+
+<BetaFeatureNotice id="ai-form" />
 
 
 ### Port AI
@@ -50,7 +50,7 @@ Perfect for immediate insights without dedicated customizations. No agents, no c
 
 
 ### AI Agents
-Customize and orchestrate complicated workflows inside Port. Build intelligent agents that can be used as part of automations and engineering workflows. **Currently in closed beta.**
+Customize and orchestrate complicated workflows inside Port. Build intelligent agents that can be used as part of automations and engineering workflows.
 
 **Use AI Agents to:**
 * Automate incident response workflows
@@ -82,7 +82,7 @@ The MCP Server provides AI machine interface capabilities that are compatible wi
 **[Set up MCP Server →](/ai-interfaces/port-mcp-server/overview-and-installation)**
 
 ### Slack App
-Interact with Port's AI capabilities directly from Slack. Ask questions, run actions, and get insights without leaving your team communication platform. **Currently in closed beta.**
+Interact with Port's AI capabilities directly from Slack. Ask questions, run actions, and get insights without leaving your team communication platform. **Currently in closed beta** - we are not accepting new applications at the moment and will update once it moves to open beta.
 
 **[Learn about the Slack App →](/ai-interfaces/slack-app)**
 
@@ -107,7 +107,7 @@ Use the **Slack App** to make AI insights available to your entire team in your
 
 Port offers four main AI interfaces:
 - **Port AI Assistant**: Chat interface for quick questions and insights.
-- **AI Agents**: Customizable workflows for automations (closed beta).
+- **AI Agents**: Customizable workflows for automations.
 - **MCP Server**: IDE integration for development workflows.
 - **Slack App**: Team collaboration interface (closed beta).
 </details>
@@ -127,18 +127,18 @@ For most users, start with **Port AI Assistant** - it provides immediate value w
 
 If you're a developer who works primarily in an IDE, consider starting with the **MCP Server** for seamless integration with your development workflow. **[Set up MCP Server →](/ai-interfaces/port-mcp-server/overview-and-installation)**
 
-For custom workflows or automation, explore **AI Agents** (requires closed beta access). **[Learn about AI Agents →](/ai-interfaces/ai-agents/overview)**
+For custom workflows or automation, explore **AI Agents**. **[Learn about AI Agents →](/ai-interfaces/ai-agents/overview)**
 
 For team collaboration, try the **Slack App** to bring AI insights into your communication platform (closed beta). **[Explore Slack App →](/ai-interfaces/slack-app)**
 </details>
 
 <details>
 <summary>What's the current availability status of Port's AI features? (Click to expand)</summary>
 
-- **Port AI Assistant**: Closed beta - gradually rolling out to users.
+- **Port AI Assistant**: Open beta - available to all users.
 - **MCP Server**: Open beta - available to all users.
-- **AI Agents**: Closed beta - requires application and approval.
-- **Slack App**: Closed beta - requires application and approval.
+- **AI Agents**: Open beta - available to all users.
+- **Slack App**: Closed beta - not accepting new applications at the moment.
 </details>
 
 <details>

docs/ai-interfaces/port-ai-assistant.md

@@ -3,11 +3,11 @@ sidebar_position: 2
 title: Port AI Assistant
 ---
 
+import BetaFeatureNotice from '/docs/generalTemplates/_beta_feature_notice.md'
+
 # Port AI Assistant
 
-:::info Closed Beta
-Port's AI offerings are currently in closed beta and will be gradually rolled out to users by the end of 2025.
-:::
+<BetaFeatureNotice id="ai-form" />
 
 The Port AI Assistant is the fastest way to start using AI with Port - no configuration required. Available through a floating chat button, it provides instant, intelligent answers about your software catalog, actions, and Port's capabilities.
 

docs/ai-interfaces/port-ai/api-interaction.md

@@ -8,9 +8,9 @@ import TabItem from "@theme/TabItem"
 
 # Port AI API Interaction
 
-:::info Closed Beta
-Port's AI offerings are currently in closed beta and will be gradually rolled out to users by the end of 2025.
-:::
+import BetaFeatureNotice from '/docs/generalTemplates/_beta_feature_notice.md'
+
+<BetaFeatureNotice id="ai-form" />
 
 Port AI can be accessed programmatically through Port's API, enabling integration into custom applications and workflows. This provides the most flexible way to incorporate Port AI capabilities into your existing tools and processes.
 

docs/ai-interfaces/port-ai/context-engineering.md

@@ -8,9 +8,9 @@ import TabItem from "@theme/TabItem"
 
 # Context Engineering with Port AI
 
-:::info Closed Beta
-Port's AI offerings are currently in closed beta and will be gradually rolled out to users by the end of 2025.
-:::
+import BetaFeatureNotice from '/docs/generalTemplates/_beta_feature_notice.md'
+
+<BetaFeatureNotice id="ai-form" />
 
 Context engineering is the practice of constructing an optimal information environment that provides the right amount of directions, tools, and knowledge for AI systems to successfully solve problems. Unlike prompt engineering, which focuses on crafting individual requests, context engineering ensures AI has access to relevant, structured data and capabilities needed for consistent, accurate results.
 

docs/ai-interfaces/port-ai/llm-providers-management/overview.md

@@ -5,9 +5,9 @@ title: Overview
 
 # LLM Provider Management
 
-:::info Closed Beta
-Port's AI offerings are currently in closed beta and will be gradually rolled out to users by the end of 2025.
-:::
+import BetaFeatureNotice from '/docs/generalTemplates/_beta_feature_notice.md'
+
+<BetaFeatureNotice id="ai-form" />
 
 :::warning Limited Availability
 The ability to configure your own LLM providers has limited availability. Please reach out to the Port support team for additional information and access.

docs/ai-interfaces/port-ai/llm-providers-management/selecting-llm-provider.md

@@ -5,9 +5,9 @@ title: Selecting LLM Provider
 
 # Selecting LLM Provider
 
-:::info Closed Beta
-Port's AI offerings are currently in closed beta and will be gradually rolled out to users by the end of 2025.
-:::
+import BetaFeatureNotice from '/docs/generalTemplates/_beta_feature_notice.md'
+
+<BetaFeatureNotice id="ai-form" />
 
 When interacting with [Port AI](/ai-interfaces/port-ai/api-interaction) through the API, you can select which provider and model to use for specific requests. This gives you fine-grained control over AI processing on a per-request basis.
 

docs/ai-interfaces/port-ai/llm-providers-management/setup-and-configuration.md

@@ -8,9 +8,9 @@ import TabItem from "@theme/TabItem"
 
 # Setup & Configuration
 
-:::info Closed Beta
-Port's AI offerings are currently in closed beta and will be gradually rolled out to users by the end of 2025.
-:::
+import BetaFeatureNotice from '/docs/generalTemplates/_beta_feature_notice.md'
+
+<BetaFeatureNotice id="ai-form" />
 
 This guide covers all technical details for setting up and configuring LLM providers, including permissions, changing defaults, validation flow, and troubleshooting common issues.