> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chkk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Comments

> A brief description, use-case, and usage instructions of the Add Comments feature

Chkk's **Add Comments** feature allows teams to capture any additional context, internal guidelines, or unique considerations at every step of an Upgrade Assessment, Upgrade Template, or Upgrade Plan.
Each upgrade—whether for a cluster, a specific Cloud Native Project, application service, or operator—consists of multiple stages, and each stage can contain multiple steps.
By placing comments directly next to these steps, users can clarify decisions (e.g., why certain Cloud Native Projects are deferred) or highlight key compliance requirements.
They can also note any organization-wide policies—such as upgrading stateful Cloud Native Projects or application services separately—so that future recommendations reflect these preferences.

Centralizing comments at the step level **reduces guesswork**, **preserves institutional knowledge**, and **standardizes workflows**.
Team members can quickly see the rationale behind key decisions, while parallel upgrade efforts become more efficient thanks to clear documentation.
In short, adding comments fosters a transparent, collaborative, and consistent upgrade process for every environment.

<Note>
  * Upgrade Assessments and Upgrade Templates (Cluster and Project) let you leave comments for Chkk and the team.
  * Upgrade Plans (Cluster and Project) let you leave comments for the team only.
</Note>

## Usage

<Note>
  The provided steps also apply to Upgrade Assessments, Cluster Upgrade Plans, Project Upgrade Plans, and Project Upgrade Templates.
</Note>

Below are the steps to **Add Comments** for both **Chkk** and **your team** on a specific step within a Cluster Upgrade Template.

<Steps>
  <Step title="Navigate to Cluster Upgrade Templates">
    1. In the **Chkk Dashboard**, expand **Upgrade Copilot** on the left menu.
    2. Click **Upgrade Templates** and then **Clusters**.
    3. You will see a list of all existing **Cluster Upgrade Templates**.
  </Step>

  <Step title="Access the Step Sidebar">
    1. Locate the **step** you want to comment on.
    2. Click the **heartbeat icon** next to that step to open the sidebar.
    3. A sidebar will appear, showing the **Activity Feed** and comment sections.
  </Step>

  <Step title="Add a Comment for Your Team">
    1. Under **Leave Comment for your team**, type your message in the text area.
    2. Click **Comment** to post it.
  </Step>

  <Step title="Add a Comment for Chkk">
    1. Under **Leave Comment for Chkk** in the same sidebar, enter your message or question for the Chkk team.
    2. Click **Comment** to post it.
    3. The Chkk team will be notified of your comment.
  </Step>
</Steps>