blob42/rusty-man
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
d0292a0dba
rusty-man/CONTRIBUTING.md

78 lines
3.1 KiB
Markdown
Raw Normal View History

Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
<!---
SPDX-FileCopyrightText: 2020 Robin Krahl <robin.krahl@ireas.org>
SPDX-License-Identifier: MIT
-->
# Contributing to rusty-man
## Project infrastructure
rusty-man is hosted on [sourcehut.org](https://sourcehut.org) and uses these
services:
- [git.sr.ht/~ireas/rusty-man][git]: Git repository
- [todo.sr.ht/~ireas/rusty-man][todo]: issue tracker
- [lists.sr.ht/~ireas/rusty-man-dev][ml]: mailing list
- [builds.sr.ht/~ireas/rusty-man][ci]: build server for continuous integration
Extend contributing guide This patch extends the CONTRIBUTING.md file with more information on possible tasks, the test suite and the code checks.
2020-07-20 08:23:28 +00:00
## How to contribute
### Writing code
Have a look at the [issues][todo] in rusty-man’s issue tracker, especially
those with the label [good first issue][], to find an issue to work on.
### Writing documentation
You can help by proofreading and extending the documentation in the readme file
and the contributing and installation guides. Also, rusty-man is lacking a man
page and a usage guide – contributions are welcome!
### Testing
If you are using rusty-man and are encountering any issues, please let me know.
I’m especially interested in reports from other operating systems than Linux.
You can also help by writing unit tests, especially for the HTML documentation
parser.
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
## Submitting patches
Extend contributing guide This patch extends the CONTRIBUTING.md file with more information on possible tasks, the test suite and the code checks.
2020-07-20 08:23:28 +00:00
Please submit patches by sending a mail to the mailing list
[~ireas/rusty-man-dev@lists.sr.ht][list]. There are three ways to do that:
1. Use [`git send-email`][] to send your patches. If you are not familiar with
the `git send-email` workflow, have a look at [this step-by-step
guide][guide] or [contact me][] for more information.
2. Or push your changes to a public repository, for example hosted on your own
Git server, sourcehut.org, Gitlab or GitHub, and use [`git request-pull`][]
to send a pull request to the mailing list.
3. If options one and two don’t work for you, just use your mail client to send
a mail with a link to your changes and a short description to the mailing
list.
## Testing and checking the code
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
Add integration tests This patch adds an integration test suite using the insta crate for snapshot testing. The test suite is tested for all supported Rust versions and should always succeed for the MSRV (currently 1.40.0) and the current stable Rust version. However there are some minor changes in the configuration format between Rust versions, so tests that don’t work on all supported Rust versions are marked with the ignore attribute. But even the ignored tests should work on the stable Rust release.
2020-07-27 12:49:51 +00:00
- rusty-man currently has very few unit tests. You can execute them using
`cargo test --bins`, but make sure to generate rusty-man’s documentation with
`cargo doc` before running the tests!
- rusty-man has an integration test suite that uses [`insta`][] for snapshot
Refactor test suite to check multiple versions This patch refactors the test suite: - Instead of always generating the documentation with the available rustdoc version, we now store generated documentation for all supported rustdoc versions in the test/html directory. - Instead of using one snapshot per test case, we now use one snapshot per test case and rustdoc version.
2020-09-11 16:14:19 +00:00
testing. The test suite uses the documentation stored in the `tests/html`
directory (generated by different versions of `rustdoc`). If you set the
`RUSTY_MAN_GENERATE` environment variable, it will also use `cargo doc` to
generate the documentation.
Extend contributing guide This patch extends the CONTRIBUTING.md file with more information on possible tasks, the test suite and the code checks.
2020-07-20 08:23:28 +00:00
- Use `cargo fmt` for code formatting.
- Fix all warnings and errors reported by `clippy`.
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
[git]: https://git.sr.ht/~ireas/rusty-man
[todo]: https://todo.sr.ht/~ireas/rusty-man
[ml]: https://lists.sr.ht/~ireas/rusty-man-dev
[ci]: https://builds.sr.ht/~ireas/rusty-man
Extend contributing guide This patch extends the CONTRIBUTING.md file with more information on possible tasks, the test suite and the code checks.
2020-07-20 08:23:28 +00:00
[good first issue]: https://todo.sr.ht/~ireas/rusty-man?search=label:%22good%20first%20issue%22%20status%3Aopen
Add installation and contributing information This patch extends the README.md file and adds the INSTALL.md and CONTRIBUTING.md files with more detailed information.
2020-07-19 23:34:56 +00:00
[list]: mailto:~ireas/rusty-man-dev@lists.sr.ht
Extend contributing guide This patch extends the CONTRIBUTING.md file with more information on possible tasks, the test suite and the code checks.
2020-07-20 08:23:28 +00:00
[`git send-email`]: https://git-scm.com/docs/git-send-email
[`git request-pull`]: https://git-scm.com/docs/git-request-pull
[guide]: https://git-send-email.io
[contact me]: mailto:robin.krahl@ireas.org
Add integration tests This patch adds an integration test suite using the insta crate for snapshot testing. The test suite is tested for all supported Rust versions and should always succeed for the MSRV (currently 1.40.0) and the current stable Rust version. However there are some minor changes in the configuration format between Rust versions, so tests that don’t work on all supported Rust versions are marked with the ignore attribute. But even the ignored tests should work on the stable Rust release.
2020-07-27 12:49:51 +00:00
[`insta`]: https://lib.rs/crates/insta
Reference in New Issue Copy Permalink