Skip to content

Latest commit

 

History

History
69 lines (51 loc) · 4.1 KB

CONTRIBUTING.md

File metadata and controls

69 lines (51 loc) · 4.1 KB

Contributing to Devopness

Thank you for considering contributing to Devopness!

We appreciate the help!

All community contributions are helpful to our team and for the Devopness community!

Before getting started ...

Show your appreciation for Devopness 💜! It means a lot to our team:

Code of Conduct

Please make sure to read and observe our Contributor Code of Conduct.

Contributing Guidelines

Getting Started

  1. Fork the repository and start working on it
  • To become familiar working with forks, please read and follow the standard fork based workflow, which could be summarized with the following steps:
    • Fork Devopness repository
    • Create a branch
    • When the changes in a branch are tested, open a pull request from your fork
  1. Report a bug 🐛 or submit new ideas 🆕 💡 3.❓ Ask questions and help other Devopness users with open discussions
  2. Find a "Good First Issue"
  • Good first issues are a great way to start contributing to the project and get familiar with the codebase. Here's how to find them:
    • Visit the "Issues" tab on the main repository
    • Use the "Labels" filter and select "Good First Issue" to see a list of beginner-friendly tasks
    • Choose an issue that interests you

Submitting a Pull Request

  1. Once you implemented a new feature or a fix for an issue, open a pull request for review
  • Please ensure all automated checks on your PR are passing, otherwise the PR will not be considered ready to be reviewed
  1. Code Review: Your pull request will be reviewed
  • Note: you might need to make changes on your pull request based on reviewers's feedbacks
  1. Merge: Once approved, maintainers will merge your pull request into the main repository branch

Pull request titles

Pull request titles should:

  • be written in the active imperative form
  • not end with a period (.)
  • be read in natural language. As a simple rule one can pretend the message in a pull request title starts with "This change will ..."
    • Example: for a pull request that has the title fix broken links on user profile page, it could be read as This change will ... fix broken links on user profile page

Here are some bad examples of pull requests titles we're trying to avoid:

  • Fixes a bug
  • Adds a feature
  • Feature now does something

Changelogs

The messages that appear in our changelogs are defined using changesets.

Click here to learn what changesets are, and how to add one.

Feature Work

For larger features, we would appreciate it if you open a new issue before investing a lot of your time trying to solve it, so we can discuss and plan the feature together.

Please also be sure to browse current issues to make sure your issue is unique, to lighten the triage burden on our maintainers. Finally, please limit your pull requests to contain only one feature at a time. Separating feature work into individual pull requests helps speed up code review and reduces the barrier to merge.

Getting Help

If you want to talk with other folks in the Devopness community (including members of the Devopness team) please start a discussion and we will soon get in touch with you.