Merge branch 'main' into HennaAbbas-patch-1

Author: rosieyohannan

.github/pull_request_template.md

@@ -1,9 +1,8 @@
-
-You may find that there are errors for the `vale/lint` job that are unrelated to your change.
-Vale checks the whole file when a change is made so if there are existing issues on the page they will be flagged.
-
-You can just leave these errors and the CircleCI docs team will address them for you.
-Vale logs are advisory to help all contributors create content that conforms to our style guide. The `vale/lint` job will not prevent changes from being published.
+> [!NOTE]
+> You may find that there are errors for the `vale/lint` job that are unrelated to your change.
+> Vale checks the whole file when a change is made so if there are existing issues on the page they will be flagged.
+> You can ignore lint errors outside your changes and the CircleCI docs team will address them for you.
+> Vale logs are advisory to help all contributors create content that conforms to our style guide. The `vale/lint` job will not prevent changes from being published.
 
 # Description
 What did you change?
@@ -15,17 +14,17 @@ Why did you make these changes? What problem does this solve?
 Please follow our style when contributing to CircleCI docs. View our [style guide](https://circleci.com/docs/style/style-guide-overview) or check out our [CONTRIBUTING.md](../CONTRIBUTING.md) for more information.
 
 **Preview your changes:**
-- To view the Vale linter results, select the `ci/circleci: lint` job at the bottom of your PR. You will be redirected to the `vale/lint` job output in CircleCI.
-- To preview your changes, select the `ci/circleci: build` job at the bottom of your PR and you will be redirected to CircleCI. Select the Artifacts tab and select `index.html` to open a preview version of the docs site built for your latest commit.
+- [ ] View the Vale linter results, select the `ci/circleci: lint` job at the bottom of your PR. You will be redirected to the `vale/lint` job output in CircleCI.
+- [ ] Preview your changes, select the `ci/circleci: build` job at the bottom of your PR and you will be redirected to CircleCI. Select the Artifacts tab and select `index.html` to open a preview version of the docs site built for your latest commit.
 
 Take a moment to check through the following items when submitting your PR (this is just a guide so will not be relevant for all PRs):
 
 **Content structure:**
-- Break up walls of text by adding paragraph breaks.
-- Consider if the content could benefit from more structure, such as lists or tables, to make it easier to consume.
-- Consider whether the content would benefit from more subsections (h2-h6 headings) to make it easier to consume.
-- Include relevant backlinks to other CircleCI docs/pages.
+- [ ] Break up walls of text by adding paragraph breaks.
+- [ ] Consider if the content could benefit from more structure, such as lists or tables, to make it easier to consume.
+- [ ] Consider whether the content would benefit from more subsections (h2-h6 headings) to make it easier to consume.
+- [ ] Include relevant backlinks to other CircleCI docs/pages.
 
 **Formatting:**
-- Keep the title between 20 and 70 characters.
-- Check all headings h1-h6 are in sentence case (only first letter is capitalized).
+- [ ] Keep the title between 20 and 70 characters.
+- [ ] Check all headings h1-h6 are in sentence case (only first letter is capitalized).

antora-playbook.yml

@@ -70,7 +70,6 @@ antora:
   - require: ./extensions/unlisted-pages-extension.js
     allowedUnlistedPages:
       - 'test:smarter-testing.adoc'
-      - 'test:fix-flaky-tests.adoc'
   - require: '@sntke/antora-mermaid-extension'
     mermaid_initialize_options:
       start_on_load: true

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

@@ -146,6 +146,8 @@
 *** xref:test:test.adoc[Automated testing]
 *** xref:test:collect-test-data.adoc[Collecting test data]
 *** xref:insights:insights-tests.adoc[Test Insights]
+** Manage and optimize tests
+*** xref:test:fix-flaky-tests.adoc[Fix flaky tests]
 ** Testing strategies
 *** xref:test:testing-llm-enabled-applications-through-evaluations.adoc[Testing LLM-enabled applications through evaluations]
 *** xref:test:browser-testing.adoc[Browser testing]
@@ -293,6 +295,7 @@
 * Developer toolkit
 ** xref:toolkit:how-to-find-ids.adoc[How to find IDs]
 ** AI features
+*** xref:guides:toolkit:chunk-setup-and-overview.adoc[Chunk Setup and Overview]
 *** xref:toolkit:using-the-circleci-mcp-server.adoc[Using the CircleCI MCP server]
 *** xref:toolkit:intelligent-summaries.adoc[Intelligent summaries]
 ** CLI