Merge branch 'master' of github.com:makeplane/docs into ui-refresh

Author: danciaclara

babel.config.js

@@ -157,7 +157,7 @@ Keep the conversation flowing on any work item with our built-in commenting syst
 
 Tag teammates for instant notifications. Just use the @ symbol followed by a team member's name, and they'll get an email notification so nothing slips through the cracks. It's perfect for when you need someone's input or want to loop them into the discussion.
 
-Full editing control - Made a typo or want to add more context? No problem. You can edit your comments anytime to keep things clear and accurate. And if you ever need to remove a comment entirely, the delete option is always there.
+Full editing control - Made a typo or want to add more context? No problem. You can edit your comments anytime to keep things clear and accurate. And if you ever need to remove a comment entirely, the delete option is always there. You can also copy a direct link to any comment. Just click the three dots on any comment and select **Copy link** to share that specific part of the conversation with others.
 
 The rich text editor gives you all the formatting tools you need - bold text for emphasis, bullet points for clarity, or even code snippets when you're discussing technical details. It's like having a mini word processor right in your work item, making it easy to communicate exactly what you mean.
 

docs/core-concepts/issues/overview.mdx

@@ -71,3 +71,7 @@ References work items directly in the editor to track details and progress.
 ## Divider
 
 Adds a horizontal line to separate content sections visually.
+
+## Emoji
+
+Add emojis to your content across all Plane editors. Type `/emoji` to open the picker or use `:` and start typing for suggestions like `:smile:`. Choose from standard Unicode emojis and GitHub's extended collection.

docs/core-concepts/pages/editor-blocks.mdx

@@ -53,43 +53,27 @@ Once created, you can view all Initiatives in the **Initiatives** section on the
 
 ![View Initiatives](https://media.docs.plane.so/initiatives/view-initiatives.webp#center)
 
-Selecting an Initiative opens its detailed view, which includes:
+Selecting an Initiative opens its detailed view. 
 
-## Progress overview
+![Initiative overview](https://media.docs.plane.so/initiatives/initiative-overview.webp#center)
 
-    ![Progress overview](https://media.docs.plane.so/initiatives/progress-overview.webp#center)
+Initiatives now offer two distinct views to help you track progress and manage scope effectively. Use the dropdown in the top navigation to switch between Overview and Scope views depending on whether you need high-level progress insights or detailed scope management.
 
-    A progress bar indicating a visual representation of project progress categorized as:
-        - Backlog
-        - Unstarted
-        - Started
-        - Completed
-        - Cancelled
+### Initiative overview
+The **Overview** gives you a bird's-eye view of your Initiative's progress. You'll see a comprehensive scope breakdown that tracks both projects and epics within your initiative, showing completion percentages and recent updates at a glance.
 
-    The percentages and counts for each category are automatically calculated based on the associated projects.
+The progress visualization at the bottom provides an instant snapshot of work distribution across different states - from backlog items to completed work. The percentages and counts for each category are automatically calculated based on the associated projects. This makes it easy to understand where your initiative stands and identify any bottlenecks in your workflow.
 
-    :::tip
-    Use Initiatives for a top-down view of progress. For detailed updates, navigate to individual projects.
-    :::
+:::tip
+Use Initiatives for a top-down view of progress. For detailed updates, navigate to individual projects.
+:::
 
-## Projects list
+### Initiative scope
+![Initiative scope](https://media.docs.plane.so/initiatives/initiative-scope.webp#center)
 
-    ![Projects list](https://media.docs.plane.so/initiatives/projects-list.webp#center)
-
-    A list of all associated projects, including:
-
-        - Project names
-        - Work item count and status
-        - Assigned leads
-        - Start and end dates
-    :::info
-    You cannot add or edit project updates directly from the Initiative view.
-    :::
-
-## Track Epics across projects
-
-    ![Add Epics](https://media.docs.plane.so/initiatives/add-epics.webp#center)
+Use the dropdown in the top navigation to switch to the **Scope** view to see all the building blocks of your initiative. Here you'll find detailed lists of:
 
+**Epics**  
 With Initiatives, you can bring together Epics from different projects into a single, high-level view. This helps you track progress across multiple workstreams in one place, giving you a clear picture of how everything is moving forward.
 
 Here’s how it helps:
@@ -102,6 +86,15 @@ After you create an Initiative and add Epics from any project. From there, you c
 
 This is perfect for cross-functional teams working on company-wide objectives, product launches, or any effort that spans multiple projects.
 
+
+**Projects**  
+Connected projects showing completion rates and key details like execution status, leads, and timelines.
+
+Each item shows its current progress, making it simple to drill down into specific areas that need attention or are ready for the next phase.
+
+Use the **Add scope** button in the top-right corner to expand your initiative by connecting additional epics and projects. This makes it easy to grow your initiative as new work streams emerge or when you need to link existing work to your strategic goals.
+
+
 ## Initiative updates
 
     ![Initiative updates](https://media.docs.plane.so/initiatives/initiative-updates.webp#center)

docs/core-concepts/projects/initiatives.mdx

@@ -176,6 +176,9 @@ You will notice that the bottom navigation bar now shows different buttons:
   <br />
 
 ## Push notifications
+:::info
+Push notifications are currently available only for Plane Cloud users.
+:::
 
 The Plane mobile app supports push notifications to keep you updated on important activities. To start receiving notifications, make sure to turn them on in the app settings. Once turned on, you'll be notified about relevant updates, ensuring you never miss an important change or task.
 

docs/devices/mobile.mdx

@@ -19,7 +19,7 @@ GitHub integration with Plane allows seamless synchronization between your GitHu
 
 ## Set up GitHub integration
 
-:::danger[Self-hosted Plane instance]
+:::danger[Self-hosted Plane instance (Commercial Edition)]
 If you're running a self-hosted instance of Plane, you'll need to set up a few extra configurations to get GitHub integration working. Check out the [setup guide](https://developers.plane.so/self-hosting/govern/integrations/github) first before diving into the steps on this page.
 :::
 

docs/integrations/github.mdx

@@ -21,7 +21,7 @@ This guide walks you through the steps to connect your GitLab account, link GitL
 
 ## Set up GitLab integration
 
-:::danger[Self-hosted Plane instance]
+:::danger[Self-hosted Plane instance (Commercial Edition)]
 If you're running a self-hosted instance of Plane, you'll need to set up a few extra configurations to get GitLab integration working. Check out the [setup guide](https://developers.plane.so/self-hosting/govern/integrations/gitlab) first before diving into the steps on this page.
 :::
 

docs/integrations/gitlab.mdx

@@ -17,7 +17,7 @@ This guide will walk you through how to set up and connect your Slack account to
 
 ## Set up Slack integration
 
-:::danger[Self-hosted instances]
+:::danger[Self-hosted instances (Commercial Edition)]
 If you're running a self-hosted instance of Plane, you'll need to set up a few extra configurations to get Slack integration working. Check out the [setup guide](https://developers.plane.so/self-hosting/govern/integrations/slack) first before diving into the steps on this page.
 :::
 
@@ -118,6 +118,26 @@ That’s it. Now the thread and the work item are connected. Comments in the thr
 
 This is perfect for situations where someone logs an issue in Plane but the conversation about it happens in Slack. Just link them up and avoid duplication.
 
+### Add Plane to private Slack channels
+When you use Plane in public Slack channels, it automatically adds the Plane bot to those channels. However, for private channels, you must manually add the bot before you can create or link work items.
+
+Here's how to add Plane to your private channels:
+
+1. Navigate to your private channel.
+2. Open the channel settings.
+3. Go to the **Integrations** tab.
+4. Click **Add apps** in the **Apps** section.
+5. Search for `Plane` in the app directory. You'll see the Plane app with the `/plane` slash command
+6. Click *Add* next to the Plane app.
+
+This will add the Plane bot to your private channel, and Slack will show you a confirmation message.
+
+:::note
+Only channel members with the right permissions can add apps to private channels. If you don't see the option to add apps, ask a channel admin or the channel creator to add Plane for you.
+:::
+
+Once you add Plane to your private channel, you can use all the same features you'd use in public channels - creating work items, linking existing ones, and getting rich link previews. The bot just needs that initial invitation to join your private conversation.
+
 ### Connect project to Slack channel
 
 Stay on top of project updates without switching tabs. You can now link each Plane project to a default Slack channel to receive notifications whenever new work items are created.

docs/integrations/slack.mdx

@@ -33,9 +33,10 @@ Templates are perfect for teams who:
    - Add a description explaining when and how to use this template.
    - Upload a cover image that represents the template.
    - Configure project properties like visibility, lead, and dates.
-   - Set up optional features like **States**, **Labels**, and **Work Item Types**.
+   - Set up optional features like **States**, **Labels**, and **Work item types**.
      ![Configure project template](https://media.docs.plane.so/templates/configure-project-template.webp#center)
    - Enable or disable **Epics** based on project needs.
+   - You can optionally define initial work items that will automatically create when teams start new projects, helping them get up and running faster with pre-structured tasks.
 6. Click **Create project template** to save.
 
 ## Use project templates

docs/templates/project-templates.mdx

@@ -33,6 +33,7 @@ Templates are perfect for teams who:
    - Add a description explaining when and how to use this template.
    - Fill in any default fields you want pre-populated (title format, description,..)
    - Configure properties like Labels, Assignees, and Modules.
+   - You can optionally define sub-work items that will automatically create along with the main work item, helping structure complex tasks from the start.
 6. Click **Create work item template** to save.
 
 ## Use work item templates