From 0e079baaf7c67c7df9521d1dd5059a293702c5d5 Mon Sep 17 00:00:00 2001 From: Jacob Hummer Date: Thu, 23 Mar 2023 18:07:08 -0500 Subject: Add contributing document (#488) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Create CONTRIBUTING.md * Direct questions to slack channel Co-authored-by: Brigit Murtaugh * Use "dev containers" and "Features" Apparently devcontainers is two words, and apparently features is a proper noun? I guess 🤷‍♂️ * Prettier formatting I used https://prettier.io/playground/ since I was editing in the GitHub web editor * Clarify to "only accept improvements and bug fixes" Co-authored-by: Samruddhi Khandale * Be more explicit about custom features Co-authored-by: Samruddhi Khandale * Add link to CLI test docs * Add semver step in guide * More specificity in link text https://github.com/devcontainers/features/pull/488#discussion_r1137819187 * Add CONTRIBUTING.md link in readme --------- Co-authored-by: Brigit Murtaugh Co-authored-by: Samruddhi Khandale --- CONTRIBUTING.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.md | 4 ++++ 2 files changed, 64 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..f6c7e3a --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,60 @@ +**Thanks for taking the time to contribute! ❤️** + +All types of contributions are encouraged and valued, no matter if it's a bug +report 🐛, a feature request 💡, or a Pull Request 🚀. + +- **❓ I have a question:** Ask in [our dev container community Slack channel] +- **🐛 I found a bug:** [Open an Issue] +- **💡 I have an idea:** [Open an Issue] +- **💻 I want to code:** See below + +If you like the project, but just don't have time to contribute, that's OK too! +You can also star the project ⭐, rave about it online 💬, or add a link to us +🔗 in your project's readme. + +⚠️ You must never report security 🔒 related issues, vulnerabilities or bugs +including sensitive information to the issue tracker, or elsewhere in public. +Instead, please [report them to the Microsoft Security Response Center]. You can +read more about our security policy in [`SECURITY.md`]. + +## Contributing code + +👨‍💼 This repository is a collection of dev container Features managed by dev +container spec maintainers. This repository will **only accept improvements and +bug fixes** for the [current set of maintained Features]. + +🚀 If you're looking to create a new Feature, then we encourage adding it to a +separate repository of your control. The [devcontainers/feature-starter] +repository has more guidance on self authoring Features. + +💡 Once you've self authored the Features and if you'd like to share them with +the community, then we'd recommend [adding it to the index]. + +👷‍ If you've identified an issue and you want to fix it, here's how you can get +started: + +1. 🔀 Fork the repo +2. 💻 Open the repo in your editor +3. 👨‍💻 Add your changes to your workspace +4. ✨ [Test your changes using `devcontainer features test`] to make sure + everything still works +5. 🆚 Bump the version of the feature you changed according to [semver] +6. 🔖 Commit & push your changes +7. 🔁 Open a PR to get your changes merged +8. 🚀 Profit! + +👩‍⚖️ When contributing code to this project, you may be asked to agree to our +[Contributor License Agreement]. + + +[our dev container community Slack channel]: https://aka.ms/devcontainer_community +[open an issue]: https://github.com/devcontainers/features/issues/new +[current set of maintained Features]: https://github.com/devcontainers/features/tree/main/src +[devcontainers/feature-starter]: https://github.com/devcontainers/feature-starter#readme +[adding it to the index]: https://github.com/devcontainers/feature-starter#adding-features-to-the-index +[report them to the Microsoft Security Response Center]: https://msrc.microsoft.com/create-report +[`SECURITY.md`]: https://github.com/devcontainers/spec/blob/main/SECURITY.md +[contributor license agreement]: https://opensource.microsoft.com/cla/ +[Test your changes using `devcontainer features test`]: https://github.com/devcontainers/cli/blob/main/docs/features/test.md +[semver]: https://semver.org/ + diff --git a/README.md b/README.md index b887c00..bfe35ba 100644 --- a/README.md +++ b/README.md @@ -109,3 +109,7 @@ We are eager to hear your feedback on self-authoring! Please provide comments a This repository will accept improvement and bug fix contributions related to the [current set of maintained Features](./src). + +🤝 You can read more about how to contribute in [`CONTRIBUTING.md`]. ❤️ + +[`CONTRIBUTING.md`]: CONTRIBUTING.md -- cgit v1.2.3