Skip to content

Latest commit

 

History

History
38 lines (24 loc) · 1.87 KB

CONTRIBUTING.md

File metadata and controls

38 lines (24 loc) · 1.87 KB

Contributing to Materialize

Thank you for your interest in Materialize! Contributions of many kinds are encouraged and most welcome.

If you have questions, please create a Github issue.

Getting started

The best place to start using Materialize is probably the documentation instructions.

Developing Materialize

After using Materialize, if you'd like to contribute, extensive documentation on our development process is available in the doc/developer folder.

Materialize is written entirely in Rust. Rust API documentation is hosted at https://mtrlz.dev/api/.

Prospective code contributors might find the good first issue tag useful.

Bug reports are welcome, and the most effective way to report a bug is to file an issue. As Materialize is under rapid development, it is helpful if you report the version of Materialize that you are using, and if it a crash report, the stack trace printed from the materialized binary.

Landing PRs + communicating changes

When landing large or substantial changes, we want to make sure users are aware of the work you're doing! This means we require:

  • Coordination with a technical writer to generate or update user-facing documentation that will show up on <materialize.com/docs>. If you have questions, open an issue with the A-docs tag.
  • Generating release notes by describing your change in doc/user/release-notes.md. If there any questions about which version the feature will be released in, consult <materialize.com/docs/versions> or chat with us.

Changes that require documentation

  • All new features
  • All API changes
  • Large bug fixes