Skip to content

Add AI-generated documentation prompt for eShopLite scenarios #36

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 9, 2025

Conversation

elbruno
Copy link
Contributor

@elbruno elbruno commented Jul 9, 2025

This pull request introduces a new AI-generated documentation prompt for the eShopLite .NET Aspire sample, aimed at streamlining the generation of detailed documentation and automated UI tests for specific scenarios. The prompt outlines a comprehensive workflow, including code analysis, documentation creation, Playwright-based testing, and screenshot embedding.

Documentation and Testing Workflow:

  • Added a detailed step-by-step prompt in prompts/generate-scenarios-docs.md for generating documentation and automated UI tests for scenarios such as 01-SemanticSearch, 03-RealtimeAudio, 05-deepseek, and 08-Sql2025. The workflow includes analyzing .NET Aspire solution files, creating feature-specific markdown documentation, generating screenshots using Playwright, and updating README files.

Copy link

github-actions bot commented Jul 9, 2025

👋 Thanks for contributing @elbruno! We will review the pull request and get back to you soon.

Copy link

github-actions bot commented Jul 9, 2025

Check Country Locale in URLs

We have automatically detected added country locale to URLs in your files.
Review and remove country-specific locale from URLs to resolve this issue.

Check the file paths and associated URLs inside them.
For more details, check our Contributing Guide.

File Full Path Issues
scenarios/08-Sql2025/README.md
#LinkLine Number
1https://learn.microsoft.com/en-us/sql/relational-databases/vectors/vectors-sql-server?view=sql-server-ver1767

Copy link

github-actions bot commented Jul 9, 2025

Check Broken Paths

We have automatically detected the following broken relative paths in your files.
Review and fix the paths to resolve this issue.

Check the file paths and associated broken paths inside them.
For more details, check our Contributing Guide.

File Full Path Issues
.github/copilot-instructions.md
#LinkLine Number
1../../README.md59

@elbruno
Copy link
Contributor Author

elbruno commented Jul 9, 2025

Check Country Locale in URLs

We have automatically detected added country locale to URLs in your files. Review and remove country-specific locale from URLs to resolve this issue.

Check the file paths and associated URLs inside them. For more details, check our Contributing Guide.

File Full Path Issues
scenarios/08-Sql2025/README.md

Link Line Number

1 https://learn.microsoft.com/en-us/sql/relational-databases/vectors/vectors-sql-server?view=sql-server-ver17 67

@copilot remove the '/en-us/' from the url in that page

@elbruno elbruno requested a review from Copilot July 9, 2025 14:16
Copy link
Contributor

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR adds a comprehensive AI prompt to generate documentation and Playwright-based UI tests for select eShopLite .NET Aspire scenarios.

  • Introduces prompts/generate-scenarios-docs.md with a step-by-step workflow covering code analysis, docs generation, Playwright scripts, screenshots, and README updates.
  • Targets four specific scenario folders (01-SemanticSearch, 03-RealtimeAudio, 05-deepseek, 08-Sql2025).
  • Defines output structure and naming conventions for generated docs and assets.
Comments suppressed due to low confidence (2)

prompts/generate-scenarios-docs.md:9

  • [nitpick] The scenario folder name uses lowercase for 'deepseek' while others use camel case. For consistency, consider using '05-DeepSeek' to match the naming style of the other scenarios.
- 05-deepseek

prompts/generate-scenarios-docs.md:6

  • [nitpick] It may help readers to know why only these four scenarios are selected. Consider adding a brief note on the selection criteria or making the list of scenarios configurable to support additional cases in the future.
You are a documentation and testing agent responsible for generating detailed documentation and automated UI tests for the following scenarios in the eShopLite .NET Aspire sample:

@elbruno
Copy link
Contributor Author

elbruno commented Jul 9, 2025

Check Country Locale in URLs

We have automatically detected added country locale to URLs in your files. Review and remove country-specific locale from URLs to resolve this issue.

Check the file paths and associated URLs inside them. For more details, check our Contributing Guide.

File Full Path Issues
scenarios/08-Sql2025/README.md

Link Line Number

1 https://learn.microsoft.com/en-us/sql/relational-databases/vectors/vectors-sql-server?view=sql-server-ver17 67

@copilot remove the '/en-us/' from the link in that page

Copy link

github-actions bot commented Jul 9, 2025

Check Broken URLs

We have automatically detected the following broken URLs in your files. Review and fix the paths to resolve this issue.

Check the file paths and associated broken URLs inside them.
For more details, check our Contributing Guide.

File Full Path Issues
README.md
#LinkLine Number
1https://dcbadge.vercel.app/api/server/ByRwuEEgH411

@elbruno elbruno merged commit 4c2d3a8 into main Jul 9, 2025
7 of 10 checks passed
@elbruno elbruno deleted the bruno-copilotinstructions branch July 9, 2025 14:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant