This project is configured to work seamlessly with GitHub Copilot, the AI coding assistant that helps speed up development and improve code quality. The following instructions outline the recommended setup and usage practices for contributors using Copilot.
-
Enable GitHub Copilot: Ensure you have an active GitHub Copilot subscription or access through your organization. You can sign up or verify your access at GitHub Copilot settings.
-
Install Copilot Extension: Install the GitHub Copilot extension for your preferred IDE. Supported environments include Visual Studio Code, JetBrains IDEs, Neovim, and others. Follow the official GitHub Copilot installation guide for your environment.
-
Configure Repository Instructions: This repository includes custom Copilot instructions to optimize its suggestions for our project structure and coding conventions. These instructions are stored in the
.github/copilot-instructions.mdfile (located in the.githubdirectory at the root of this repository) and are automatically used whenever Copilot assists you within this repository.
- Follow the style guidelines and conventions documented in this repository to ensure consistent code quality.
- Utilize Copilot suggestions as a starting point but review and adjust the code for correctness and project-specific requirements.
- If project conventions or coding standards change, please update the
.github/copilot-instructions.mdfile to ensure Copilot continues to provide relevant, high-quality suggestions. - If you encounter repeated undesired suggestions, update or request changes to the
.github/copilot-instructions.mdto improve context for the AI assistant.
- If you need help with Copilot, have questions about its use in this project, or want to suggest improvements for the Copilot setup or instructions, please open a discussion or issue in this repository. The project maintainers will be happy to assist you!
This section serves as a clear, user-friendly guide to help contributors set up and utilize GitHub Copilot effectively within this repository. It includes steps for onboarding, information about custom instructions file usage, and links to relevant resources for further help.