Skip to content

Adds Copilot instructions #6787

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

Draft
wants to merge 3 commits into
base: main
Choose a base branch
from

Conversation

waldekmastykarz
Copy link
Member

No description provided.

@Adam-it Adam-it self-assigned this Jul 19, 2025
Copy link
Member

@Adam-it Adam-it left a comment

Choose a reason for hiding this comment

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

@waldekmastykarz awesome work.
In general I don't have that much experience in this area (I only added cp-instructions to two other repos and most of the times I just left what copilot generated itself 😜) but I left some small comments/ideas that I had when comparing this file to other repos.
Please let me know what do you think about my feedback. It is more a open discussion or an idea we might consider now or later, not something that has to be updated or done 🙂


## References
- [Main README](../README.md)
- [Contributing Guide](../CONTRIBUTING.md)
Copy link
Member

Choose a reason for hiding this comment

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

I wonder if this is a good point of additional context for Copilot. TBH the contributing.md now is just a general page how to go about it on GH and with actually coding we should rather look for guidance at https://pnp.github.io/cli-microsoft365/contribute/contributing-guide

Copy link
Member Author

Choose a reason for hiding this comment

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

Good point, let's update.

- **Lint**: `npm run lint` (uses custom ESLint rules from `eslint-rules/`)
- **Watch**: `npm run watch` (TypeScript in watch mode)
- **Symlink for local CLI**: `npm link` (after build)
- **Node version**: Must be 22 (see `scripts/check-version.js`)
Copy link
Member

Choose a reason for hiding this comment

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

again I wonder if it is a huge benefit to specify the node version. For sure another place for us to remember

Copy link
Member Author

Choose a reason for hiding this comment

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

It might be valuable in case someone runs into issues and they have no idea why. Aren't we updating it with find & replace?

@@ -0,0 +1,57 @@
# Copilot Instructions for CLI for Microsoft 365
Copy link
Member

Choose a reason for hiding this comment

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

I wonder if it be worth adding a section like
## Useful Context in which we would specify perfect places to use as context for common operations that we may do in this repo.
For example:

Copy link
Member Author

Choose a reason for hiding this comment

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

I wonder if pointing Copilot at an existing command wouldn't be better reference than a human-friendly description we've got in our docs.

Copy link
Member

Choose a reason for hiding this comment

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

Good idea, but we need to be sure the command is simple and up to date with our latest practicies

@Adam-it Adam-it marked this pull request as draft July 19, 2025 21:40
waldekmastykarz and others added 2 commits July 22, 2025 07:57
Co-authored-by: Adam Wójcik <58668583+Adam-it@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants