| 1 |
If you send a pull request / patch, please observe the following. |
| 2 |
|
| 3 |
## Licensing |
| 4 |
|
| 5 |
Since this crate is dual-licensed, |
| 6 |
[section 5 of the Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0#contributions) |
| 7 |
is considered to apply in the sense of Contributions being automatically |
| 8 |
under the Apache License 2.0 or MIT dual license (see the `COPYRIGHT` file). |
| 9 |
That is, by the act of offering a Contribution, you place your Contribution |
| 10 |
under the Apache License 2.0 or MIT dual license stated in the `COPYRIGHT` |
| 11 |
file. Please do not contribute if you aren't willing or allowed to license your |
| 12 |
contributions in this manner. |
| 13 |
|
| 14 |
You are encouraged to dedicate test code that you contribute to the Public |
| 15 |
Domain using the CC0 dedication. If you contribute test code that is not |
| 16 |
dedicated to the Public Domain, please be sure not to put it in a part of |
| 17 |
source code that the comments designate as being dedicated to the Public |
| 18 |
Domain. |
| 19 |
|
| 20 |
## Copyright Notices |
| 21 |
|
| 22 |
If you require the addition of your copyright notice, it's up to you to edit in |
| 23 |
your notice as part of your Contribution. Not adding a copyright notice is |
| 24 |
taken as a waiver of copyright notice. |
| 25 |
|
| 26 |
## No Encodings Beyond The Encoding Standard |
| 27 |
|
| 28 |
Please do not contribute implementations of encodings that are not specified |
| 29 |
in the [Encoding Standard](https://encoding.spec.whatwg.org/). |
| 30 |
|
| 31 |
For example, an implementation of UTF-7 is explicitly out of scope for this |
| 32 |
crate and is, therefore, provided by the [`charset`](https://crates.io/crates/charset) |
| 33 |
crate instead. For single-byte DOS encodings, please see the |
| 34 |
[`oem_cp`](https://crates.io/crates/oem_cp) crate. |
| 35 |
|
| 36 |
## Compatibility with Stable Rust |
| 37 |
|
| 38 |
Please ensure that your Contribution compiles with the latest stable-channel |
| 39 |
rustc. |
| 40 |
|
| 41 |
## rustfmt |
| 42 |
|
| 43 |
The `rustfmt` version used for this code is `rustfmt-nightly`. Please either |
| 44 |
use that version or avoid using `rustfmt` (so as not to reformat all the code). |
| 45 |
|
| 46 |
## Unit tests |
| 47 |
|
| 48 |
Please ensure that `cargo test` succeeds. |