File: CONTRIBUTING.md

package info (click to toggle)
libh3 4.4.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 48,700 kB
  • sloc: ansic: 20,847; javascript: 632; sh: 46; makefile: 9
file content (24 lines) | stat: -rw-r--r-- 1,422 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# Contributing to the H3 project

Pull requests and Github issues are welcome!

Planned improvements and changes are discussed in Github issues. Feel free to open a discussion proposing a new one.

## Pull requests

* Please include tests that show the bug is fixed or feature works as intended.
* Please include fuzzer tests for public API functions.
* Please add a description of your change to the Unreleased section of the [changelog](./CHANGELOG.md).
* Please open issues to discuss large features or changes which would break compatibility, before submitting pull requests.
* Please keep H3 compatible with major C compilers, such as GCC, Clang, and MSVC. We use clang-format-14 for source code formatting, if you have another version the CI job may error on formatting differences.
* Please keep code coverage of the core H3 library at 100%.

Before we can merge your changes, you must agree to the [Uber Contributor License Agreement](https://cla-assistant.io/uber/h3).

## Other ways to contribute

In addition to making pull requests and Github issues on the @uber/h3 repository, there are other ways you can contribute. Here are some suggestions:

* Writing and updating the [documentation website](./website/docs/).
* Writing [bindings](./website/docs/community/bindings.md) for your preferred language.
* Writing components so that your preferred GIS, mapping, or visualization system can display H3 indexes.