From 2ae58c1674ff33bfac11f3ccd21f680bb8c04a14 Mon Sep 17 00:00:00 2001 From: Andrew Zigler Date: Tue, 7 Jan 2025 16:35:23 -0800 Subject: [PATCH 1/4] =?UTF-8?q?=F0=9F=93=9D=20docs:=20improve=20askAI=20pl?= =?UTF-8?q?ugin=20documentation=20and=20FAQ=20clarity?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Updates documentation for the askAI plugin and FAQ sections to provide clearer information about data privacy, API usage, and supported features. Includes better formatting, more precise descriptions of the plugin's functionality, and improved examples of how to use the askAI integration with OpenAI's latest model. The documentation now better explains the data privacy implications of using AI features and provides more accurate technical details about the OpenAI integration. The FAQ section has been streamlined for better readability and understanding of gitStream's capabilities. --- docs/faq.md | 7 ++++--- docs/integrations/askAI.md | 26 +++++++++++--------------- plugins/filters/askAI/index.js | 14 +++++++------- plugins/filters/askAI/reference.md | 22 +++++++++++----------- 4 files changed, 33 insertions(+), 36 deletions(-) diff --git a/docs/faq.md b/docs/faq.md index 94d2d81f..c884d1ee 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -14,11 +14,12 @@ Choose which repositories are permitted to use GitHub Actions. [x] Allow all actions and reusable workflows -## Does gitStream services have access to my code? +## Does gitStream have access to my code? -Like any other CI/CD automation, the source code is being scanned in the repo and is not shared with any external services. Only metadata related to and affecting the workflow is shared to allow rule-based automation on the repo. +Like any other CI/CD automation, the source code is being scanned in the repo and is not shared with any external services. Only metadata related to and affecting the workflow is shared to allow rule-based automation on the repo. An exception to this is when you configure your own gitStream plugins that may connect to other services, such as using the [`askAI`](/filter-function-plugins/#askai) plugin, which will provide context to the configured model provider. ## Why does gitStream require permission to write code? + To support automations that either Approve or Merge PRs, the git providers require code write scope. ## What repos are supported? @@ -34,7 +35,7 @@ Yes. When a merge queue is used, and gitStream is set as a required check, gitSt The `.cm` file uses YAML with JINJA2. For your favorite editor to automatically choose the right syntax, you can use modelines. -Add the following line to the top of the `.cm` file (the default has it already): +Add the following line to the top of the `.cm` file (the default has it already): ``` # -*- mode: yaml -*- diff --git a/docs/integrations/askAI.md b/docs/integrations/askAI.md index a27d4aa4..e2451aef 100644 --- a/docs/integrations/askAI.md +++ b/docs/integrations/askAI.md @@ -1,43 +1,39 @@ --- title: Integrate gitStream with AI -description: Use gitStream to integrate with AI services for Review, describe and add tests. +description: Use gitStream to integrate with AI for different use cases. category: [quality, genai, copilot, tests, efficiency] --- # Integrate gitStream with AI !!! warning "Required gitStream Plugins" - This example requires you to install the [`askAI`](/filter-function-plugins/#askai) plugin. + This example requires you to install the [`askAI`](/filter-function-plugins/#askai) plugin, which will provide context to the configured model provider and may incur API costs. [Learn more about gitStream plugins](/plugins/). -## Ask AI to Summarize the Changes in a PR +## Ask AI to summarize the changes in a PR --8<-- "docs/automations/integrations/askAI/summarize-pr/README.md:example" -## Ask AI to Suggest Tests - ---8<-- "docs/automations/integrations/askAI/add-tests/README.md:example" - -## Ask AI for a Code Review +## Ask AI to review the changes in a PR --8<-- "docs/automations/integrations/askAI/code-review/README.md:example" -## Ask AI for Documentation +## Ask AI for improvements to the changes in a PR ---8<-- "docs/automations/integrations/askAI/document/README.md:example" +--8<-- "docs/automations/integrations/askAI/improve/README.md:example" -## Ask AI for Code Improvements +## Ask AI for documentation covering the changes in a PR ---8<-- "docs/automations/integrations/askAI/improve/README.md:example" +--8<-- "docs/automations/integrations/askAI/document/README.md:example" - +--8<-- "docs/automations/integrations/askAI/add-tests/README.md:example" ## Additional Resources --8<-- "docs/snippets/general.md" ---8<-- "docs/snippets/automation-footer.md" \ No newline at end of file +--8<-- "docs/snippets/automation-footer.md" diff --git a/plugins/filters/askAI/index.js b/plugins/filters/askAI/index.js index 21a20f6b..1f357507 100644 --- a/plugins/filters/askAI/index.js +++ b/plugins/filters/askAI/index.js @@ -1,12 +1,12 @@ /** * @module askAI - * @description A gitStream plugin to interact with AI models. Currently works with `ChatGPR-4o-mini`. - * @param {Object} context - The context that will be attached to the prompt . - * @param {string} role - Role instructions for the conversation. - * @param {string} prompt - The prompt string. - * @param {Object} token - The token to the AI model. - * @returns {Object} Returns the response from the AI model. - * @example {{ branch | generateDescription(pr, repo, source) }} + * @description A gitStream plugin to facilitate AI workflows with OpenAI's `gpt-4o-2024-08-06` model. + * @param {Object} context - The context to be sent to the AI model with the prompt. + * @param {string} role - The system role or persona for the AI to adopt while generating the response. + * @param {string} prompt - The specific request or question you want the AI to respond to, after the context has been provided. + * @param {Object} token - Your OpenAI API token. + * @returns {Object} Returns the AI-generated response based on the provided context and prompt. + * @example {{ source | askAI("Experienced developer", "Summarize the changes in this PR in bullet points.", env.OPEN_AI_TOKEN) }} * @license MIT * */ diff --git a/plugins/filters/askAI/reference.md b/plugins/filters/askAI/reference.md index 1884e4f4..1c111573 100644 --- a/plugins/filters/askAI/reference.md +++ b/plugins/filters/askAI/reference.md @@ -1,26 +1,26 @@ ## askAI -A gitStream plugin to interact with AI models. Currently works with `ChatGPR-4o-mini` -![Example PR description](screenshots/askAI-describe-PR.png) +!!! warning "Data privacy" + The [`askAI`](/filter-function-plugins/#askai) plugin will provide context to the configured model provider and may incur API costs. + + [Learn more about gitStream plugins](/plugins/). + +A gitStream plugin to facilitate AI workflows with OpenAI's `gpt-4o-2024-08-06` model. **Returns**: Object - Returns the AI-generated response based on the provided context and prompt. **License**: MIT | Param | Type | Description | | ------- | -------- | ------------------------------------------------------------------------------------------------------------------ | -| context | `Object` | The context that needs to be sent to the AI model for analysis. | -| role | `string` | Free text. If not empty, Defines the role or persona for the AI to adopt while generating the response. | +| context | `Object` | The context to be sent to the AI model with the prompt. | +| role | `string` | The system role or persona for the AI to adopt while generating the response. | | prompt | `string` | The specific request or question you want the AI to respond to, after the context has been provided. | -| token | `Object` | The token to the AI model | - +| token | `string` | Your OpenAI API token. | **Example** -!!! tip "Encoding output" - The output of AI models may be lengthy, which might cause issues when setting the comment. We recommend using the [`encode`](./filter-functions.md#encode) filter function, as shown in the example, to ensure that the comment is passed fully. - The [`add-comment`](./automation-actions.md#add-comment) action automatically decodes encoded strings. - + ```yaml -{{ source | askAI("QA tester", "Based on the given context, search for new functions without tests and suggest the tests to add. If all functions are covered completely, return 'no tests to suggest.'", env.OPEN_AI_TOKEN) }} +{{ {{ source | askAI("Experienced developer", "Summarize the changes in this PR in bullet points.", env.OPEN_AI_TOKEN) }} }} ``` From c1440a3973567fdfd2fffbb7e5e2caed3b01fb96 Mon Sep 17 00:00:00 2001 From: Andrew Zigler Date: Wed, 8 Jan 2025 08:21:43 -0800 Subject: [PATCH 2/4] =?UTF-8?q?=F0=9F=93=9D=20docs:=20improve=20clarity=20?= =?UTF-8?q?of=20AI=20plugin=20documentation=20and=20fix=20example=20syntax?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Documentation has been updated to be more precise about data sharing in gitStream and to fix syntax in the askAI plugin example. The parameter type for the token argument has been corrected from Object to string in the JSDoc comments to better reflect its actual type. --- docs/faq.md | 2 +- plugins/filters/askAI/index.js | 2 +- plugins/filters/askAI/reference.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/faq.md b/docs/faq.md index c884d1ee..fe77bd7a 100644 --- a/docs/faq.md +++ b/docs/faq.md @@ -16,7 +16,7 @@ Choose which repositories are permitted to use GitHub Actions. ## Does gitStream have access to my code? -Like any other CI/CD automation, the source code is being scanned in the repo and is not shared with any external services. Only metadata related to and affecting the workflow is shared to allow rule-based automation on the repo. An exception to this is when you configure your own gitStream plugins that may connect to other services, such as using the [`askAI`](/filter-function-plugins/#askai) plugin, which will provide context to the configured model provider. +Like any other CI/CD automation, the source code is being scanned in the repo and is not shared with any external services. By default, only metadata related to and affecting the workflow is shared to allow rule-based automation on the repo. Your own gitStream plugins that may connect to other services, such as using the [`askAI`](/filter-function-plugins/#askai) plugin which will provide context to the configured model provider. ## Why does gitStream require permission to write code? diff --git a/plugins/filters/askAI/index.js b/plugins/filters/askAI/index.js index 1f357507..75b2d900 100644 --- a/plugins/filters/askAI/index.js +++ b/plugins/filters/askAI/index.js @@ -4,7 +4,7 @@ * @param {Object} context - The context to be sent to the AI model with the prompt. * @param {string} role - The system role or persona for the AI to adopt while generating the response. * @param {string} prompt - The specific request or question you want the AI to respond to, after the context has been provided. - * @param {Object} token - Your OpenAI API token. + * @param {string} token - Your OpenAI API token. * @returns {Object} Returns the AI-generated response based on the provided context and prompt. * @example {{ source | askAI("Experienced developer", "Summarize the changes in this PR in bullet points.", env.OPEN_AI_TOKEN) }} * @license MIT diff --git a/plugins/filters/askAI/reference.md b/plugins/filters/askAI/reference.md index 1c111573..eca0091f 100644 --- a/plugins/filters/askAI/reference.md +++ b/plugins/filters/askAI/reference.md @@ -22,5 +22,5 @@ A gitStream plugin to facilitate AI workflows with OpenAI's `gpt-4o-2024-08-06` **Example** ```yaml -{{ {{ source | askAI("Experienced developer", "Summarize the changes in this PR in bullet points.", env.OPEN_AI_TOKEN) }} }} +{{ source | askAI("Experienced developer", "Summarize the changes in this PR in bullet points.", env.OPEN_AI_TOKEN) }} ``` From baae64ce053facd5588a2c987bc9fc0ad45cd185 Mon Sep 17 00:00:00 2001 From: Andrew Zigler Date: Wed, 8 Jan 2025 12:19:28 -0800 Subject: [PATCH 3/4] =?UTF-8?q?=F0=9F=93=9D=20docs:=20improve=20clarity=20?= =?UTF-8?q?and=20consistency=20in=20askAI=20documentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Improves documentation for askAI features by standardizing titles, descriptions, and formatting across all automation files. Updates prompts to be more specific and adds consistent footers to AI responses. Makes labels formatting consistent using backticks and enhances readability of configuration descriptions. --- .../integrations/askAI/add-tests/README.md | 12 ++++++------ .../integrations/askAI/code-review/README.md | 12 ++++++------ .../integrations/askAI/document/README.md | 13 +++++++------ .../integrations/askAI/improve/README.md | 13 +++++++------ .../integrations/askAI/summarize-pr/README.md | 12 ++++++------ .../integrations/askAI/askAI_CR.cm | 12 +++++++----- .../integrations/askAI/askAI_document.cm | 12 +++++++----- .../integrations/askAI/askAI_improve.cm | 10 ++++++---- .../integrations/askAI/askAI_summarize.cm | 7 ++++--- .../integrations/askAI/askAI_tests.cm | 12 +++++++----- docs/integrations/askAI.md | 10 +++++----- 11 files changed, 68 insertions(+), 57 deletions(-) diff --git a/docs/automations/integrations/askAI/add-tests/README.md b/docs/automations/integrations/askAI/add-tests/README.md index 9989e688..167beacb 100644 --- a/docs/automations/integrations/askAI/add-tests/README.md +++ b/docs/automations/integrations/askAI/add-tests/README.md @@ -1,24 +1,24 @@ --- -title: Automation - Ask AI to Suggest Tests -description: Use gitStream's integration with AI services to suggests additional tests +title: Automation - Ask AI for Tests for a PR +description: Use gitStream's integration with AI services to recommend tests for the changes in the PR. category: [quality, genai, copilot, tests, efficiency] starter_kits: [genai] --- -# Ask AI to Suggest Tests +# Ask AI for Tests for a PR -Use AI to suggests additional test cases for uncovered or modified functions in the PR, including edge cases. +Use AI to recommend tests for the changes in a PR. !!! info "Configuration Description" Conditions (all must be true): * A PR is created or new code has been committed to the PR. - * The PR has a label "askai tests" + * The PR has a label `askai tests`. Automation Actions: - * Add a comment with suggested tests generated by an AI model + * Add a comment with AI-generated tests recommendations for the PR. !!! example "Configuration Example" ```yaml+jinja diff --git a/docs/automations/integrations/askAI/code-review/README.md b/docs/automations/integrations/askAI/code-review/README.md index 8d5534d9..c899085d 100644 --- a/docs/automations/integrations/askAI/code-review/README.md +++ b/docs/automations/integrations/askAI/code-review/README.md @@ -1,24 +1,24 @@ --- -title: Automation - Ask AI for a Code Review -description: Use gitStream's integration with AI services to perform a comprehensive code review to your code +title: Automation - Ask AI to Review a PR +description: Use gitStream's integration with AI services to perform a initial code review for a PR. category: [quickstart, quality, genai, copilot, tests, efficiency] starter_kits: [genai] --- -# Ask AI for a Code Review +# Ask AI to Review a PR -Use AI to perform a comprehensive code review, identify bugs, security risks, performance issues, deprecated methods, and style guide violations, and suggests improvements. +Use AI to generate an initial code review checklist, identify bugs, security risks, performance issues, deprecated methods, and style guide violations, and suggests improvements. The automation provides insights and recommended next actions for a human reviewer. !!! info "Configuration Description" Conditions (all must be true): * A PR is created or new code has been committed to the PR. - * The PR has a label "askai cr" + * The PR has a label `askai cr`. Automation Actions: - * Add a comment with a code review generated by an AI model + * Add a comment with an AI-generated code review checklist for the PR. !!! example "Configuration Example" ```yaml+jinja diff --git a/docs/automations/integrations/askAI/document/README.md b/docs/automations/integrations/askAI/document/README.md index 9f712502..2e8214b3 100644 --- a/docs/automations/integrations/askAI/document/README.md +++ b/docs/automations/integrations/askAI/document/README.md @@ -1,23 +1,24 @@ --- -title: Automation - Ask AI to Summarize the Changes in a PR -description: Use gitStream's integration with AI services to generate a summary of the changes in the PR. +title: Automation - Ask AI for Documentation for a PR +description: Use gitStream's integration with AI services to recommend documentation for the changes in the PR. category: [quality, genai, copilot, tests, efficiency] +starter_kits: [genai] --- -# Ask AI to Summarize the Changes in a PR +# Ask AI for Documentation for a PR -Use AI to generate a documentation for the newly added features and changes based on the code diff. +Use AI to recommend new or updated documentation for changes in a PR, focusing on functionality, parameters, and expected behavior. !!! info "Configuration Description" Conditions (all must be true): * A PR is created or new code has been committed to the PR. - * The PR has a label "askai document" + * The PR has a label `askai document`. Automation Actions: - * Add a comment with a summary of the PR + * Add a comment with AI-generated documentation recommendations for the PR. !!! example "Configuration Example" ```yaml+jinja diff --git a/docs/automations/integrations/askAI/improve/README.md b/docs/automations/integrations/askAI/improve/README.md index 6b6fc36e..b321cc4d 100644 --- a/docs/automations/integrations/askAI/improve/README.md +++ b/docs/automations/integrations/askAI/improve/README.md @@ -1,23 +1,24 @@ --- -title: Automation - Ask AI to Summarize the Changes in a PR -description: Use gitStream's integration with AI services to generate a summary of the changes in the PR. +title: Automation - Ask AI for Improvements to a PR +description: Use gitStream's integration with AI services to recommend improvements to a PR. category: [quality, genai, copilot, tests, efficiency] +starter_kits: [genai] --- -# Ask AI to provide code suggestion to improve the PR +# Ask AI for Improvements to a PR -Use AI to generate improvement suggestions for the code changes. +Use AI to recommend improvements to a PR that enhance readability, performance, security, and maintainability. !!! info "Configuration Description" Conditions (all must be true): * A PR is created or new code has been committed to the PR. - * The PR has a label "askai improve" + * The PR has a label `askai improve`. Automation Actions: - * Add a comment with omprovement suggestions for the added code + * Add a comment with AI-generated improvement suggestions for the PR. !!! example "Configuration Example" ```yaml+jinja diff --git a/docs/automations/integrations/askAI/summarize-pr/README.md b/docs/automations/integrations/askAI/summarize-pr/README.md index 75726646..c3c24bc2 100644 --- a/docs/automations/integrations/askAI/summarize-pr/README.md +++ b/docs/automations/integrations/askAI/summarize-pr/README.md @@ -1,13 +1,13 @@ --- -title: Automation - Ask AI to Summarize the Changes in a PR -description: Use gitStream's integration with AI services to generate a summary of the changes in the PR. +title: Automation - Ask AI to Summarize a PR +description: Use gitStream's integration with AI services to generate a concise bullet-point summary of a PR. category: [quality, genai, copilot, tests, efficiency] starter_kits: [genai] --- -# Ask AI to Summarize the Changes in a PR +# Ask AI to Summarize a PR -Use AI to generate a concise bullet-point summary of the changes in the pull request. +Use AI to generate a concise bullet-point summary of changes in a PR. ![summarized-pr](/automations/integrations/askAI/summarize-pr/summarized-pr.png) @@ -16,11 +16,11 @@ Use AI to generate a concise bullet-point summary of the changes in the pull req Conditions (all must be true): * A PR is created or new code has been committed to the PR. - * The PR has a label "askai summarize" + * The PR has a label `askai summarize`. Automation Actions: - * Add a comment with a summary of the PR + * Add a comment with an AI-generated summary of the PR. !!! example "Configuration Example" ```yaml+jinja diff --git a/docs/downloads/automation-library/integrations/askAI/askAI_CR.cm b/docs/downloads/automation-library/integrations/askAI/askAI_CR.cm index b9354e7c..00af0159 100644 --- a/docs/downloads/automation-library/integrations/askAI/askAI_CR.cm +++ b/docs/downloads/automation-library/integrations/askAI/askAI_CR.cm @@ -14,9 +14,11 @@ automations: - action: add-comment@v1 args: comment: | - # ✨ gitStream Review ✨ - {{ source | askAI("Code reviewer", + ## gitStream askAI: code review checklist for this PR ✨ + {{ source | askAI("experienced software developer focused on code reviews", "Review the PR code diff. - - Identify bugs, security risks, and performance issues - - Check for deprecated methods and style guide violations - - Provide specific improvement suggestions based on the changes", env.OPEN_AI_TOKEN) }} \ No newline at end of file + - Identify bugs, security risks, and performance issues. + - Check for deprecated methods and style guide violations. + - Suggest specific improvements based on the changes. + - Provide a code review checklist that can be utilized by a human reviewer.", env.OPEN_AI_TOKEN) }} + _This response was generated by the gitStream askAI plugin._ \ No newline at end of file diff --git a/docs/downloads/automation-library/integrations/askAI/askAI_document.cm b/docs/downloads/automation-library/integrations/askAI/askAI_document.cm index 6fa28377..0cc3b34d 100644 --- a/docs/downloads/automation-library/integrations/askAI/askAI_document.cm +++ b/docs/downloads/automation-library/integrations/askAI/askAI_document.cm @@ -14,8 +14,10 @@ automations: - action: add-comment@v1 args: comment: | - # 🧪 Test Suggestions 🧪 - {{ source | askAI("Technical writer", - "Review the code diff and generate documentation for any newly added features or significant changes. - Focus on describing functionality, parameters, and expected behavior. - Format the output in clear, concise bullet points or paragraphs.", env.OPEN_AI_TOKEN) }} \ No newline at end of file + ## gitStream askAI: recommended documentation for this PR 📑 + {{ source | askAI("experienced technical writer focused on documentation", + "Review the PR code diff. + - Generate documentation for any newly added features or significant changes. + - Focus on describing functionality, parameters, and expected behavior. + - Format the output in clear, concise bullet points or paragraphs.", env.OPEN_AI_TOKEN) }} + _This response was generated by the gitStream askAI plugin._ \ No newline at end of file diff --git a/docs/downloads/automation-library/integrations/askAI/askAI_improve.cm b/docs/downloads/automation-library/integrations/askAI/askAI_improve.cm index 5918a697..469d584a 100644 --- a/docs/downloads/automation-library/integrations/askAI/askAI_improve.cm +++ b/docs/downloads/automation-library/integrations/askAI/askAI_improve.cm @@ -14,7 +14,9 @@ automations: - action: add-comment@v1 args: comment: | - # 🧪 Test Suggestions 🧪 - {{ source | askAI("Experienced developer", - "Review the code diff and suggest improvements to enhance readability, performance, and maintainability. - Focus only on the modified code and provide specific, actionable recommendations.", env.OPEN_AI_TOKEN) }} \ No newline at end of file + ## gitStream askAI: recommended improvements for this PR 🔨 + {{ source | askAI("experienced software developer focused on code reviews", + "Review the PR code diff. + - Suggest improvements to enhance readability, performance, security, and maintainability. + - Focus only on the modified code and provide specific, actionable recommendations.", env.OPEN_AI_TOKEN) }} + _This response was generated by the gitStream askAI plugin._ \ No newline at end of file diff --git a/docs/downloads/automation-library/integrations/askAI/askAI_summarize.cm b/docs/downloads/automation-library/integrations/askAI/askAI_summarize.cm index 43b6819f..a1be1253 100644 --- a/docs/downloads/automation-library/integrations/askAI/askAI_summarize.cm +++ b/docs/downloads/automation-library/integrations/askAI/askAI_summarize.cm @@ -14,6 +14,7 @@ automations: - action: add-comment@v1 args: comment: | - # 📜 PR Summary 📜 - {{ source | askAI("Experienced developer", - "Summarize the changes in this PR in bullet points.", env.OPEN_AI_TOKEN) }} \ No newline at end of file + ## gitStream askAI: summary for this PR 📜 + {{ source | askAI("experienced software developer focused on code reviews", + "Review the PR code diff. + - Summarize the changes in the PR in an unordered list.", env.OPEN_AI_TOKEN) }} \ No newline at end of file diff --git a/docs/downloads/automation-library/integrations/askAI/askAI_tests.cm b/docs/downloads/automation-library/integrations/askAI/askAI_tests.cm index 6f9991b3..e295a851 100644 --- a/docs/downloads/automation-library/integrations/askAI/askAI_tests.cm +++ b/docs/downloads/automation-library/integrations/askAI/askAI_tests.cm @@ -14,8 +14,10 @@ automations: - action: add-comment@v1 args: comment: | - # 🧪 Test Suggestions 🧪 - {{ source | askAI("QA tester", - "Identify any new or modified functions without test coverage in this PR. - Suggest specific test cases to add, including edge cases. - If all functions are covered, return 'No additional tests needed.'", env.OPEN_AI_TOKEN) }} \ No newline at end of file + ## gitStream askAI: recommended tests for this PR 🧪 + {{ source | askAI("experienced software developer focused on QA testing", + "Review the PR code diff. + - Identify any new or modified functions without test coverage. + - Suggest specific test cases to add, including edge cases. + - If all functions are covered, return 'No additional tests needed.'", env.OPEN_AI_TOKEN) }} + _This response was generated by the gitStream askAI plugin._ \ No newline at end of file diff --git a/docs/integrations/askAI.md b/docs/integrations/askAI.md index e2451aef..93d2c611 100644 --- a/docs/integrations/askAI.md +++ b/docs/integrations/askAI.md @@ -11,23 +11,23 @@ category: [quality, genai, copilot, tests, efficiency] [Learn more about gitStream plugins](/plugins/). -## Ask AI to summarize the changes in a PR +## Ask AI to Summarize a PR --8<-- "docs/automations/integrations/askAI/summarize-pr/README.md:example" -## Ask AI to review the changes in a PR +## Ask AI to Review a PR --8<-- "docs/automations/integrations/askAI/code-review/README.md:example" -## Ask AI for improvements to the changes in a PR +## Ask AI for Improvements to a PR --8<-- "docs/automations/integrations/askAI/improve/README.md:example" -## Ask AI for documentation covering the changes in a PR +## Ask AI for Documentation for a PR --8<-- "docs/automations/integrations/askAI/document/README.md:example" -## Ask AI for tests covering the changes in a PR +## Ask AI for Tests for a PR --8<-- "docs/automations/integrations/askAI/add-tests/README.md:example" From 0331f239a8fbb3b8ccd54510b51dd1f91197a89a Mon Sep 17 00:00:00 2001 From: Andrew Zigler Date: Thu, 9 Jan 2025 12:51:09 -0800 Subject: [PATCH 4/4] =?UTF-8?q?=F0=9F=93=9D=20docs:=20improve=20titles=20a?= =?UTF-8?q?nd=20descriptions=20in=20AI=20integration=20documentation?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The documentation titles and descriptions are now more clear and consistent. The changes make the purpose of each AI integration more explicit and actionable. For example, "Ask AI to Review a PR" becomes "Ask AI for a PR Review Checklist" which better describes the actual functionality. --- .../automations/integrations/askAI/add-tests/README.md | 6 +++--- .../integrations/askAI/code-review/README.md | 4 ++-- docs/automations/integrations/askAI/document/README.md | 4 ++-- docs/automations/integrations/askAI/improve/README.md | 4 ++-- docs/integrations/askAI.md | 10 +++++----- 5 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/automations/integrations/askAI/add-tests/README.md b/docs/automations/integrations/askAI/add-tests/README.md index 167beacb..83950117 100644 --- a/docs/automations/integrations/askAI/add-tests/README.md +++ b/docs/automations/integrations/askAI/add-tests/README.md @@ -1,13 +1,13 @@ --- -title: Automation - Ask AI for Tests for a PR +title: Automation - Ask AI to Generate Unit Tests description: Use gitStream's integration with AI services to recommend tests for the changes in the PR. category: [quality, genai, copilot, tests, efficiency] starter_kits: [genai] --- -# Ask AI for Tests for a PR +# Ask AI to Generate Unit Tests -Use AI to recommend tests for the changes in a PR. +Use AI to recommend unit tests for the changes in a PR. !!! info "Configuration Description" diff --git a/docs/automations/integrations/askAI/code-review/README.md b/docs/automations/integrations/askAI/code-review/README.md index c899085d..7c786e64 100644 --- a/docs/automations/integrations/askAI/code-review/README.md +++ b/docs/automations/integrations/askAI/code-review/README.md @@ -1,10 +1,10 @@ --- -title: Automation - Ask AI to Review a PR +title: Automation - Ask AI for a PR Review Checklist description: Use gitStream's integration with AI services to perform a initial code review for a PR. category: [quickstart, quality, genai, copilot, tests, efficiency] starter_kits: [genai] --- -# Ask AI to Review a PR +# Ask AI for a PR Review Checklist Use AI to generate an initial code review checklist, identify bugs, security risks, performance issues, deprecated methods, and style guide violations, and suggests improvements. The automation provides insights and recommended next actions for a human reviewer. diff --git a/docs/automations/integrations/askAI/document/README.md b/docs/automations/integrations/askAI/document/README.md index 2e8214b3..ebf3b243 100644 --- a/docs/automations/integrations/askAI/document/README.md +++ b/docs/automations/integrations/askAI/document/README.md @@ -1,10 +1,10 @@ --- -title: Automation - Ask AI for Documentation for a PR +title: Automation - Ask AI to Generate Documentation description: Use gitStream's integration with AI services to recommend documentation for the changes in the PR. category: [quality, genai, copilot, tests, efficiency] starter_kits: [genai] --- -# Ask AI for Documentation for a PR +# Ask AI to Generate Documentation Use AI to recommend new or updated documentation for changes in a PR, focusing on functionality, parameters, and expected behavior. diff --git a/docs/automations/integrations/askAI/improve/README.md b/docs/automations/integrations/askAI/improve/README.md index b321cc4d..2f6e8c3b 100644 --- a/docs/automations/integrations/askAI/improve/README.md +++ b/docs/automations/integrations/askAI/improve/README.md @@ -1,10 +1,10 @@ --- -title: Automation - Ask AI for Improvements to a PR +title: Automation - Ask AI for PR Improvements description: Use gitStream's integration with AI services to recommend improvements to a PR. category: [quality, genai, copilot, tests, efficiency] starter_kits: [genai] --- -# Ask AI for Improvements to a PR +# Ask AI for PR Improvements Use AI to recommend improvements to a PR that enhance readability, performance, security, and maintainability. diff --git a/docs/integrations/askAI.md b/docs/integrations/askAI.md index 93d2c611..c04bc944 100644 --- a/docs/integrations/askAI.md +++ b/docs/integrations/askAI.md @@ -7,7 +7,7 @@ category: [quality, genai, copilot, tests, efficiency] !!! warning "Required gitStream Plugins" - This example requires you to install the [`askAI`](/filter-function-plugins/#askai) plugin, which will provide context to the configured model provider and may incur API costs. + These examples requires you to install the [`askAI`](/filter-function-plugins/#askai) plugin, which will provide context to the configured model provider and may incur API costs. [Learn more about gitStream plugins](/plugins/). @@ -15,19 +15,19 @@ category: [quality, genai, copilot, tests, efficiency] --8<-- "docs/automations/integrations/askAI/summarize-pr/README.md:example" -## Ask AI to Review a PR +## Ask AI for a PR Review Checklist --8<-- "docs/automations/integrations/askAI/code-review/README.md:example" -## Ask AI for Improvements to a PR +## Ask AI for PR Improvements --8<-- "docs/automations/integrations/askAI/improve/README.md:example" -## Ask AI for Documentation for a PR +## Ask AI to Generate Documentation --8<-- "docs/automations/integrations/askAI/document/README.md:example" -## Ask AI for Tests for a PR +## Ask AI to Generate Tests --8<-- "docs/automations/integrations/askAI/add-tests/README.md:example"