Skip to content

Commit

Permalink
chore: Initial commit for contribution doc
Browse files Browse the repository at this point in the history
  • Loading branch information
jakewvincent committed Aug 14, 2024
1 parent 789bed4 commit 4b8df63
Showing 1 changed file with 51 additions and 0 deletions.
51 changes: 51 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Contributing to Mkdnflow

Thanks for considering contributing to Mkdnflow!

## How to contribute

### Reporting bugs

To submit a bug report, use the bug report issue template and follow the instructions within the template.

* Use a clear and descriptive title for the issue to identify the problem.
* Describe the exact steps which reproduce the problem in as many details as possible.
* Provide specific examples to demonstrate the steps.

### Suggesting features and enhancements

Suggestions are welcome, including completely new features or minor improvements to existing functionality.

* Use a clear and descriptive title for the issue to identify the suggestion.
* Provide a step-by-step description of the suggested enhancement in as many details as possible.
* Provide specific examples to demonstrate the steps.

### Pull requests

Pull requests are welcome for both bugfixes and new features. I reserve the right not to merge a PR in any case. In all such cases, I will communicate with you on the PR to let you know whether/what changes need to be made to the PR before it can be merged.

* Clearly describe what the pull request does
* Include screenshots or animated GIFs in your pull request when sensible.
* Use [**Conventional Commits**](https://www.conventionalcommits.org/)! Otherwise, I will ask you to revise your PR.
* When a PR adds or changes a feature, update the documentation as well.

## Styleguides

### Git commit messages

This project now uses the [Conventional Commits](https://www.conventionalcommits.org/) specification for its commit messages. This provides a number of benefits, including better human and machine readability and compliance with the requirements for automatic versioning, which is used in the main branch.

In addition to using conventional commits, please adhere to the following when writing commit messages:

1. Use the present tense in the imperative mood ("Add feature", not "Added feature" or "Adds feature")
2. Limit the first line to 72 characters or less
3. Reference issues and pull requests liberally after the first line

Examples:

```
feat: Add new mapping for buffer navigation
fix: Resolve issue with autocmd not firing
docs: Update installation instructions in README
refactor: Simplify autocommand setup
```

0 comments on commit 4b8df63

Please sign in to comment.