mirror of
https://github.com/teloxide/teloxide.git
synced 2025-01-18 15:20:15 +01:00
Apply suggestions from code review
Co-authored-by: Hirrolot <hirrolot@gmail.com>
This commit is contained in:
parent
1b983e043f
commit
243bfa8460
1 changed files with 2 additions and 2 deletions
|
@ -42,7 +42,7 @@ impl<T: Trait> Trait for Wrap<T> { ... }
|
||||||
## Documentation comments
|
## Documentation comments
|
||||||
|
|
||||||
1. Documentation must describe _what_ your code does and mustn't describe _how_ your code does it and bla-bla-bla.
|
1. Documentation must describe _what_ your code does and mustn't describe _how_ your code does it and bla-bla-bla.
|
||||||
2. Be sure that your comments follow the grammar, including punctuation, the first capital letter and so on.
|
2. Be sure that your comments follow the grammar, including punctuation, the first capital letter and so on:
|
||||||
```rust
|
```rust
|
||||||
// GOOD
|
// GOOD
|
||||||
/// This function makes a request to Telegram.
|
/// This function makes a request to Telegram.
|
||||||
|
@ -52,7 +52,7 @@ impl<T: Trait> Trait for Wrap<T> { ... }
|
||||||
/// this function make request to telegram
|
/// this function make request to telegram
|
||||||
pub fn make_request(url: &str) -> String { ... }
|
pub fn make_request(url: &str) -> String { ... }
|
||||||
```
|
```
|
||||||
3. Do not use ending punctuation in short list items (usually containing just one phrase or sentence).
|
3. Do not use ending punctuation in short list items (usually containing just one phrase or sentence):
|
||||||
```md
|
```md
|
||||||
<!-- GOOD -->
|
<!-- GOOD -->
|
||||||
- Handle different kinds of Update
|
- Handle different kinds of Update
|
||||||
|
|
Loading…
Reference in a new issue