Updating contributing guide to be correct
This commit is contained in:
parent
6e5c7d4459
commit
d2cfaeecd9
4
.github/pull_request_template.md
vendored
4
.github/pull_request_template.md
vendored
@ -5,7 +5,7 @@
|
|||||||
- [ ] The file follows the required naming convention.
|
- [ ] The file follows the required naming convention.
|
||||||
- [ ] The content is clearly structured and follows the example format.
|
- [ ] The content is clearly structured and follows the example format.
|
||||||
- [ ] I have tested my instructions, prompt, or chat mode with GitHub Copilot.
|
- [ ] I have tested my instructions, prompt, or chat mode with GitHub Copilot.
|
||||||
- [ ] I have run `node update-readme.js` and verified that `README.md` is up to date.
|
- [ ] I have run `npm start` and verified that `README.md` is up to date.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
@ -20,6 +20,8 @@
|
|||||||
- [ ] New instruction file.
|
- [ ] New instruction file.
|
||||||
- [ ] New prompt file.
|
- [ ] New prompt file.
|
||||||
- [ ] New chat mode file.
|
- [ ] New chat mode file.
|
||||||
|
- [ ] New collection file.
|
||||||
|
- [ ] Update to existing instruction, prompt, chat mode, or collection.
|
||||||
- [ ] Other (please specify):
|
- [ ] Other (please specify):
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|||||||
4
.github/workflows/contributors.yml
vendored
4
.github/workflows/contributors.yml
vendored
@ -31,7 +31,9 @@ jobs:
|
|||||||
PRIVATE_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
PRIVATE_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
||||||
|
|
||||||
- name: Regenerate README
|
- name: Regenerate README
|
||||||
run: node update-readme.js
|
run: |
|
||||||
|
npm install
|
||||||
|
npm start
|
||||||
|
|
||||||
- name: Check for changes
|
- name: Check for changes
|
||||||
id: verify-changed-files
|
id: verify-changed-files
|
||||||
|
|||||||
13
.github/workflows/validate-readme.yml
vendored
13
.github/workflows/validate-readme.yml
vendored
@ -27,11 +27,14 @@ jobs:
|
|||||||
with:
|
with:
|
||||||
node-version: "20"
|
node-version: "20"
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: npm install
|
||||||
|
|
||||||
- name: Validate collections
|
- name: Validate collections
|
||||||
run: node validate-collections.js
|
run: npm run validate:collections
|
||||||
|
|
||||||
- name: Update README.md
|
- name: Update README.md
|
||||||
run: node update-readme.js
|
run: npm start
|
||||||
|
|
||||||
- name: Check for file changes
|
- name: Check for file changes
|
||||||
id: check-diff
|
id: check-diff
|
||||||
@ -64,9 +67,9 @@ jobs:
|
|||||||
message: |
|
message: |
|
||||||
## ⚠️ Generated files need to be updated
|
## ⚠️ Generated files need to be updated
|
||||||
|
|
||||||
The `update-readme.js` script detected changes that need to be made.
|
The update script detected changes that need to be made.
|
||||||
|
|
||||||
Please run `node update-readme.js` locally and commit the changes before merging this PR.
|
Please run `npm start` locally and commit the changes before merging this PR.
|
||||||
|
|
||||||
<details>
|
<details>
|
||||||
<summary>View diff</summary>
|
<summary>View diff</summary>
|
||||||
@ -79,5 +82,5 @@ jobs:
|
|||||||
- name: Fail workflow if files need updating
|
- name: Fail workflow if files need updating
|
||||||
if: steps.check-diff.outputs.status == 'failure'
|
if: steps.check-diff.outputs.status == 'failure'
|
||||||
run: |
|
run: |
|
||||||
echo "❌ Generated files need to be updated. Please run 'node update-readme.js' locally and commit the changes."
|
echo "❌ Generated files need to be updated. Please run `npm start` locally and commit the changes."
|
||||||
exit 1
|
exit 1
|
||||||
|
|||||||
@ -183,7 +183,7 @@ For full example of usage checkout edge-ai tasks collection:
|
|||||||
1. **Fork this repository**
|
1. **Fork this repository**
|
||||||
2. **Create a new branch** for your contribution
|
2. **Create a new branch** for your contribution
|
||||||
3. **Add your instruction, prompt file, chatmode, or collection** following the guidelines above
|
3. **Add your instruction, prompt file, chatmode, or collection** following the guidelines above
|
||||||
4. **Run the update script** (optional): `node update-readme.js` to update the README with your new file
|
4. **Run the update script**: `npm start` to update the README with your new file (make sure you run `npm install` first if you haven't already)
|
||||||
- A GitHub Actions workflow will verify that this step was performed correctly
|
- A GitHub Actions workflow will verify that this step was performed correctly
|
||||||
- If the README.md would be modified by running the script, the PR check will fail with a comment showing the required changes
|
- If the README.md would be modified by running the script, the PR check will fail with a comment showing the required changes
|
||||||
5. **Submit a pull request** with:
|
5. **Submit a pull request** with:
|
||||||
|
|||||||
@ -51,8 +51,8 @@ node create-collection.js my-collection-id
|
|||||||
1. Create `collections/my-collection-id.collection.yml`
|
1. Create `collections/my-collection-id.collection.yml`
|
||||||
2. Use the template above as starting point
|
2. Use the template above as starting point
|
||||||
3. Add your items and customize settings
|
3. Add your items and customize settings
|
||||||
4. Run `node validate-collections.js` to validate
|
4. Run `npm run validate:collections` to validate
|
||||||
5. Run `node update-readme.js` to generate documentation
|
5. Run `npm start` to generate documentation
|
||||||
|
|
||||||
## Validation
|
## Validation
|
||||||
|
|
||||||
@ -64,7 +64,7 @@ Collections are automatically validated to ensure:
|
|||||||
|
|
||||||
Run validation manually:
|
Run validation manually:
|
||||||
```bash
|
```bash
|
||||||
node validate-collections.js
|
npm run validate:collections
|
||||||
```
|
```
|
||||||
|
|
||||||
## File Organization
|
## File Organization
|
||||||
@ -78,4 +78,4 @@ Collections don't require reorganizing existing files. Items can be located anyw
|
|||||||
3. **Good Descriptions**: Explain who should use the collection and what benefit it provides
|
3. **Good Descriptions**: Explain who should use the collection and what benefit it provides
|
||||||
4. **Relevant Tags**: Add discovery tags that help users find related collections
|
4. **Relevant Tags**: Add discovery tags that help users find related collections
|
||||||
5. **Reasonable Size**: Keep collections focused - typically 3-10 items work well
|
5. **Reasonable Size**: Keep collections focused - typically 3-10 items work well
|
||||||
6. **Test Items**: Ensure all referenced files exist and are functional before adding to a collection
|
6. **Test Items**: Ensure all referenced files exist and are functional before adding to a collection
|
||||||
|
|||||||
@ -166,8 +166,8 @@ display:
|
|||||||
console.log("\n📝 Next steps:");
|
console.log("\n📝 Next steps:");
|
||||||
console.log("1. Edit the collection manifest to add your items");
|
console.log("1. Edit the collection manifest to add your items");
|
||||||
console.log("2. Update the name, description, and tags as needed");
|
console.log("2. Update the name, description, and tags as needed");
|
||||||
console.log("3. Run 'node validate-collections.js' to validate");
|
console.log("3. Run 'npm run validate:collections' to validate");
|
||||||
console.log("4. Run 'node update-readme.js' to generate documentation");
|
console.log("4. Run 'npm start' to generate documentation");
|
||||||
console.log("\n📄 Collection template contents:");
|
console.log("\n📄 Collection template contents:");
|
||||||
console.log(template);
|
console.log(template);
|
||||||
} catch (error) {
|
} catch (error) {
|
||||||
|
|||||||
@ -48,7 +48,7 @@ When working with collections in the awesome-copilot repository:
|
|||||||
|
|
||||||
## Generation Process
|
## Generation Process
|
||||||
|
|
||||||
- Collections automatically generate README files via `update-readme.js`
|
- Collections automatically generate README files via `npm start`
|
||||||
- Individual collection pages are created in collections/ directory
|
- Individual collection pages are created in collections/ directory
|
||||||
- Main collections overview is generated as README.collections.md
|
- Main collections overview is generated as README.collections.md
|
||||||
- VS Code install badges are automatically created for each item
|
- VS Code install badges are automatically created for each item
|
||||||
|
|||||||
@ -2,14 +2,15 @@
|
|||||||
"name": "awesome-copilot",
|
"name": "awesome-copilot",
|
||||||
"version": "1.0.0",
|
"version": "1.0.0",
|
||||||
"description": "Enhance your GitHub Copilot experience with community-contributed instructions, prompts, and chat modes",
|
"description": "Enhance your GitHub Copilot experience with community-contributed instructions, prompts, and chat modes",
|
||||||
"main": "update-readme.js",
|
"main": "./eng/update-readme.js",
|
||||||
"private": true,
|
"private": true,
|
||||||
"scripts": {
|
"scripts": {
|
||||||
"start": "npm run build",
|
"start": "npm run build",
|
||||||
"build": "node ./eng/update-readme.js",
|
"build": "node ./eng/update-readme.js",
|
||||||
"contributors:add": "all-contributors add",
|
"contributors:add": "all-contributors add",
|
||||||
"contributors:generate": "all-contributors generate",
|
"contributors:generate": "all-contributors generate",
|
||||||
"contributors:check": "all-contributors check"
|
"contributors:check": "all-contributors check",
|
||||||
|
"validate:collections": "node ./eng/validate-collections.js"
|
||||||
},
|
},
|
||||||
"repository": {
|
"repository": {
|
||||||
"type": "git",
|
"type": "git",
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user