Debian Codegraph @

.cargo/vendor/encoding_rs/CONTRIBUTING.md

raw
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.