You want to help us improve our little library? That's awesome! You're awesome!
Whether you have a feature request, found a bug, want to add some code of your own or even just have a question - all of these are very welcome.
Our library is pretty small, so let's try and go easy on the rules. :)
- Have a question? Open an issue!
- Found a bug? Open an issue!
- Would you like to request a feature, change or improvement? Open an issue!
You could also always check out list of issues and see if there's any discussions you want to share your thoughts on.
Wow, that's even better!
In principle this as easy as forking the repository, making some changes and opening a pull request. From there, we'll review your PR as soon as we can manage, ask questions or request changes if necessary, and once we're happy merge it into our main branch. It's that easy!
If you want to know ahead of time if we'd welcome a certain feature or change, you could always create an issue where you propose that change and mention that you'd like to implement it yourself. We'll let you know what we think as soon as we can. The main reason we might decline code is if we feel it doesn't fit with the purpose of our libraries, but we're very open to suggestions and good arguments.
You can also browse the existing issues for inspiration. You can pick up anything, but we also have the good-first-issue label to indicate which issues are easy to pick up for someone new to the code base.
When writing code for Bearded.Utilities, keep the following things in mind:
- We like pull requests to be as small as possible, but as large as necessary, to make them as easy to review as possible
- We like organised, consistent, clean, readable and maintainable code, see what's already there for examples (or submit a change if you think you can improve it!)
- We like modern C# features, type-safety and care about performance
- We like tests
Also remember to assign yourself to an issue if you start working on it.
Be as clear as you can: Whether you're opening your own issue or PR, or just commenting on them, take the time to express your ideas as clearly as you can. The clearer your message, the better we will understand you, and the easier it will be for us to help you or to take your thoughts into consideration.
Don't worry about not knowing or understanding things: Everyone has questions, gaps in their knowledge, or is unfamilar with certain topics. If you're unsure about anything, just ask! There are no dumb questions.