update after review

Author: rosieyohannan

docs/guides/modules/ROOT/images/chunk/allow-chunk-tasks.png

@@ -5,7 +5,7 @@
 :experimental:
 :page-noindex: true
 
-NOTE: Chunk by CircleCI is currently in *beta*. There are no extra costs during beta, Chunk uses CircleCI credits and your AI model provider token. Chunk tasks will be a paid feature when generally available.
+NOTE: Chunk by CircleCI is currently in *beta*. There are no extra costs during beta, Chunk uses CircleCI credits and your AI model provider tokens. Chunk tasks will be a paid feature when generally available.
 
 TIP: Have feedback or feature requests? Submit them on our link:https://circleci.canny.io/cloud-feature-requests?selectedCategory=chunk-ai[Ideas board, window=_blank] where you can also see existing feature requests and vote on them.
 
@@ -150,6 +150,11 @@ Pull requests contain code diffs showing what changes Chunk recommends, along wi
 
 Once you have assigned Chunk some tasks, you can view an activity timeline on the Chunk dashboard. Tasks are available in a list view below the chat interface.
 
+There are two types of task, both are listed in the Chunk tasks dashboard.
+
+*Manual tasks*:: Created by prompting Chunk from the chat interface. Manual tasks appear in the ist view immediately after first message to Chunk.
+*Schedule tasks*:: Created via the btn:[Schedule a task] button. Schedule tasks appear once the task runs on the selected schedule and if Chunk was able to open a fixPR.
+
 .See Chunk tasks listed below chat interface
 image::guides:ROOT:chunk/chunk-chat.png[Chunk tasks listed in chat view]
 

docs/guides/modules/test/pages/fix-flaky-tests.adoc

@@ -4,7 +4,7 @@
 :page-description: Learn how to set up Chunk by CircleCI and see what it can do.
 :experimental:
 
-NOTE: Chunk by CircleCI is currently in *beta*. There are no extra costs during beta. Chunk uses CircleCI credits and your AI model provider token. Chunk tasks will be a paid feature when generally available.
+NOTE: Chunk by CircleCI is currently in *beta*. There are no extra costs during beta. Chunk uses CircleCI credits and your AI model provider tokens. Chunk tasks will be a paid feature when generally available.
 
 TIP: *Feedback or feature requests?* Submit them on our link:https://circleci.canny.io/cloud-feature-requests?selectedCategory=chunk-ai[Ideas board, window=_blank] where you can also see existing feature requests and vote on them.
 
@@ -32,6 +32,7 @@ Ensure you have the following prerequisites in place before you get started:
 ** Make sure your organization link:https://help.openai.com/en/articles/10910291-api-organization-verification#h_c6efff0719[has gpt-5 model access, window=_blank].
 ** Verify your organization. For guidance see the link:https://help.openai.com/en/articles/10910291-api-organization-verification[OpenAI help, window=_blank]. If you cannot get your OpenAI organization verified, see the troubleshooting item <<i-cannot-get-my-openai-organization-verified>>.
 * Ensure you have the CircleCI GitHub App installed in your GitHub organization. Check menu:Organization Settings[VCS Connections]. Chunk needs the GitHub App installed to be able to recommend fixes and open pull requests.
+* Allow Chunk tasks for your organization: Navigate to menu:Organization Settings[Advanced] and select to toggle on the *Allow Chunk tasks* option.
 
 === Setup
 
@@ -104,7 +105,9 @@ Chunk supports all standard CircleCI configuration options. This includes execut
 
 When scheduling a task, just store your `cci-agent-setup.yml` in your repo and Chunk will pick it up automatically.
 
-When using the chat interface, use the environment selection below the chat text field to set up your environment. You will also be able to add secrets (environment variables) to Chunk's environment here if needed. These secrets will be added to a context named `chunk-<your-environment-name>`.
+When using the chat interface, use the environment selection below the chat text field to set up your environment. If you keep the `Default` environment selected, Chunk will look for a `cci-agent-setup.yml` file in the root of your repository. If you wish to name this file differently, create a custom environment and provide chunk with the name of the file.
+
+You can also add secrets (environment variables) to Chunk's environment here if needed. These secrets will be added to a context named `chunk-<your-environment-name>`.
 
 .Creating an environment for Chunk to use
 image::guides:ROOT:chunk/chunk-create-environment.png[Create an environment for Chunk to use]
@@ -233,7 +236,7 @@ Contexts:: If you are using CircleCI contexts to manage secrets or environment v
 
 === Configuring Chunk's environment when using the chat interface
 
-Using Chunk's chat interface to describe a task, you can tell Chunk which project, repository and branch you want to work on. You can also select and/or set up Chunk's environment here. Using the Environment selector you can set up your environment to give ch
+Using Chunk's chat interface to describe a task, you can tell Chunk which project, repository and branch you want to work on. You can also select and/or set up Chunk's environment here. Using the Environment selector you can set up your environment to give chunk access to any secrets needed or provide Chunk with the name of your agents `.yml` file if different from the default `cci-agent-setup.yml`.
 
 === Testing your environment setup
 To build and iterate on Chunk's environment follow these steps:
@@ -247,10 +250,17 @@ This page lets you run the contents of your cci-agent-setup.yml file on a specif
 Merge the `cci-agent-setup.yml` file to your default branch when the results on the environment setup page are satisfactory.
 
 === Additional guidance for Chunk
-To improve Chunk's ability to run tests and produce fixes that are aligned with stylistic/architectural preferences, you can include instructions. Your instructions can be in a markdown file (`claude.md` or `agents.md`) in the root of your repository or in a custom `cci-agent-setup.yml` file. Chunk should pick this up automatically.
+To improve Chunk's ability to run tests and produce fixes that are aligned with stylistic/architectural preferences, you can include instructions. Your instructions can be in a markdown file (`claude.md` or `agents.md`) in the root of your repository. Chunk should pick this up automatically.
 
 == Troubleshooting
 
+=== I cannot see the Chunk option in the sidebar
+
+If you do not see Chunk image:guides:ROOT:icons/chunk.svg[Chunk icon, role="no-border"] in the sidebar, you may not have the *Allow Chunk tasks* option enabled. Navigate to menu:Organization Settings[Advanced] and select to toggle on the *Allow Chunk tasks* option.
+
+.Organization settings > Advanced > Allow Chunk tasks
+image::guides:ROOT:chunk/allow-chunk-tasks.png[Allow Chunk tasks]
+
 === I cannot get my OpenAI organization verified
 
 If organization verification is not possible, you can bypass this requirement by adding an environment variable to your `circleci-agents` context, as follows: