mirror of
https://github.com/RustAudio/rodio
synced 2024-12-05 01:39:15 +00:00
Point to rustdoc book in CONTRIBUTING.md
Specifically request contributors to take a look at the documenting a component section.
This commit is contained in:
parent
a5a49fb5a2
commit
02933d4adf
1 changed files with 4 additions and 1 deletions
|
@ -76,6 +76,7 @@ When possible, add integration tests for your new features. Keep in mind:
|
||||||
## Documentation
|
## Documentation
|
||||||
|
|
||||||
- Add inline documentation to all public items.
|
- Add inline documentation to all public items.
|
||||||
|
- Look at the [documenting components](https://doc.rust-lang.org/rustdoc/how-to-write-documentation.html#documenting-components) section of the rustdoc book.
|
||||||
- Generate docs: `cargo doc --open`
|
- Generate docs: `cargo doc --open`
|
||||||
- Add an example. That could be as part of the inline documentation or a more complex scenario in `examples/`
|
- Add an example. That could be as part of the inline documentation or a more complex scenario in `examples/`
|
||||||
|
|
||||||
|
@ -108,9 +109,9 @@ When possible, add integration tests for your new features. Keep in mind:
|
||||||
## Getting Help / Got a question?
|
## Getting Help / Got a question?
|
||||||
|
|
||||||
- Open an issue on GitHub
|
- Open an issue on GitHub
|
||||||
- Join the Rust Audio Discord
|
|
||||||
- Ask questions in your pull request
|
- Ask questions in your pull request
|
||||||
- Open an issue for guidance/questions
|
- Open an issue for guidance/questions
|
||||||
|
- Join the Rust Audio Discord
|
||||||
|
|
||||||
## Useful Commands
|
## Useful Commands
|
||||||
|
|
||||||
|
@ -123,9 +124,11 @@ For more detailed information, refer to the full documentation and source code.
|
||||||
## Useful External Resources
|
## Useful External Resources
|
||||||
|
|
||||||
- [Rust API Guidelines](https://rust-lang.github.io/api-guidelines/)
|
- [Rust API Guidelines](https://rust-lang.github.io/api-guidelines/)
|
||||||
|
- [Rustdoc book](https://doc.rust-lang.org/rustdoc/how-to-write-documentation.html)
|
||||||
- [Rust Performance Book](https://nnethercote.github.io/perf-book/introduction.html)
|
- [Rust Performance Book](https://nnethercote.github.io/perf-book/introduction.html)
|
||||||
- [Rust Audio Discord](https://discord.com/invite/8qW6q2k)
|
- [Rust Audio Discord](https://discord.com/invite/8qW6q2k)
|
||||||
|
|
||||||
|
|
||||||
## Disclaimer
|
## Disclaimer
|
||||||
|
|
||||||
Please note that the guidelines and practices outlined in this document
|
Please note that the guidelines and practices outlined in this document
|
||||||
|
|
Loading…
Reference in a new issue