- 
                Notifications
    
You must be signed in to change notification settings  - Fork 86
 
docs: remove duplicate tool listings and improve organization #125
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
base: main
Are you sure you want to change the base?
Conversation
Remove 5 duplicate tool listings, move a few tools to more appropriate sections, and update a few descriptions.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Orca Security Scan Summary
| Status | Check | Issues by priority | |
|---|---|---|---|
| Infrastructure as Code | View in Orca | ||
| SAST | View in Orca | ||
| Secrets | View in Orca | ||
| Vulnerabilities | View in Orca | 
There was a problem hiding this 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 cleans up the README documentation by removing 5 duplicate tool listings that appeared multiple times across different sections, reorganizing tools into their appropriate categories, and improving tool descriptions for clarity.
Key changes:
- Removed duplicate entries for 
list_organizations,list_branch_computes,list_slow_queries,explain_sql_statement,prepare_query_tuning, andcomplete_query_tuning - Moved 
list_organizationsto the Project Management section where it belongs - Consolidated query performance tools under a single "Query Performance Optimization" section
 - Updated descriptions to be more consistent and removed overly specific implementation details
 
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| - **`explain_sql_statement`**: Analyzes a SQL query and returns detailed execution plan information to help understand query performance. | ||
| - **`prepare_query_tuning`**: Identifies potential performance issues in a SQL query and suggests optimizations. Creates a temporary branch for testing improvements. | ||
| - **`complete_query_tuning`**: Finalizes and applies query optimizations after testing. Merges changes from the temporary tuning branch to the main branch. | ||
| - **`provision_neon_auth`**: Provisions Neon Auth for a Neon project. It allows developers to easily set up authentication infrastructure by creating an integration with an Auth provider. | 
    
      
    
      Copilot
AI
    
    
    
      Oct 24, 2025 
    
  
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
[nitpick] The updated description is now too generic. While removing specific mention of Stack Auth may be intentional to be provider-agnostic, 'an Auth provider' is vague. Consider specifying 'supported Auth providers' or linking to documentation that lists compatible providers to help users understand what authentication services can be integrated.
| - **`provision_neon_auth`**: Provisions Neon Auth for a Neon project. It allows developers to easily set up authentication infrastructure by creating an integration with an Auth provider. | |
| - **`provision_neon_auth`**: Provisions Neon Auth for a Neon project. It allows developers to easily set up authentication infrastructure by creating an integration with a supported Auth provider. See [Supported Auth Providers](https://docs.neon.tech/auth/providers) for a list of compatible authentication services. | 
Remove 5 duplicate tool listings, move a few tools to more appropriate sections, and update a few descriptions.