Skip to content

Latest commit

 

History

History
161 lines (116 loc) · 4.33 KB

contributing.md

File metadata and controls

161 lines (116 loc) · 4.33 KB
Raw

Contributing

Hi! 👋 Take a moment to read the following guidelines. Thanks for contributing!

Contents

Expectations

This community has a code of conduct. You must follow it when interacting with the community.

Be respectful and considerate when asking for things. You are not entitled to free customer service.

Be friendly! Be excellent to each other.

Ecosystem

Pick the right place to contribute. The collective (unified) is hundreds of projects in several organizations. Often there is a utility (such as mdast-util-to-hast), a plugin (remark-rehype), relating to a syntax tree (mdast) and an ecosystem (remark). If you are not sure where to contribute, you can first ask a question.

Support

See support.md on how to get help.

Contributions

There are several ways to contribute.

Financial support

Support our efforts financially. Sponsor us on GitHub, thanks.dev, or OpenCollective.

Improve documentation

Fix that typo. As a user you are perfect for helping us improve the docs. Better explanations, new examples, etcetera.

Improve issues

Help make issues easier to resolve. Some issues lack information, are not reproducible, or are just incorrect.

Give feedback on issues

Share your perspective. We are often looking for more opinions, insights, and use cases.

Write code

Contribute a test, patch a bug, add a feature. It’s often good to first create a discussion or an issue before a pull request. Perhaps there’s a reason things are the way they are. Or there’s an alternative solution.

Submitting an issue

  • see support.md for help; the issue tracker is for issues
  • search discussions and issues before opening something, include links to what you find
  • contribute a failing test if you can
  • use the latest version of projects
  • use a clear and descriptive title
  • include as much information as possible
  • be friendly!
  • the more time you put into an issue, the easier it is to help you

Submitting a pull request

  • non-trivial things are often best discussed first, to prevent you from doing unnecessary work
  • for ambitious tasks, try to get your work in front of the community for feedback as soon as possible
  • do one thing and do it well, do not include unrelated changes
  • include tests and documentation
  • run npm test to make sure everything’s still fine
  • write a convincing description of why we should land your pull request: it’s your job to convince us

Resources

License

This document has the following license: CC-BY-4.0 © Titus Wormer