Add a style guide for the docs ()

This commit is contained in:
Chris Wong 2021-11-29 22:06:56 +11:00 committed by GitHub
parent 2f3d68c8a4
commit ca860d09bd
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 22 additions and 5 deletions

View file

@ -2,6 +2,8 @@
This directory contains the documentation for Maud.
It is hosted at <https://maud.lambda.xyz>.
## Build
Build the documentation:
@ -14,6 +16,18 @@ You can also delete the build artifacts with:
make clean
## Style
- [Be brief][short].
- Use [semantic line breaks][sembr].
- American spelling.
- Parentheticals should use spaced en dashes
like this
not em dashes.
[short]: https://developers.google.com/tech-writing/one/short-sentences
[sembr]: https://sembr.org/
## Watch
To ease editing,

View file

@ -89,9 +89,10 @@ html! {
## Optional attributes: `title=[Some("value")]`
Add optional attributes to an element using `attr=[value]` syntax, with *square*
brackets. These are only rendered if the value is `Some<T>`, and entirely
omitted if the value is `None`.
Add optional attributes to an element using `attr=[value]` syntax,
with *square* brackets.
These are only rendered if the value is `Some<T>`,
and entirely omitted if the value is `None`.
```rust
# let _ = maud::

View file

@ -118,8 +118,10 @@ maud = { version = "*", features = ["tide"] }
# ...
```
This adds an implementation of `From<PreEscaped<String>>` for the `Response` struct.
Once provided, callers may return results of `html!` directly as responses:
This adds an implementation of `From<PreEscaped<String>>`
for the `Response` struct.
Once provided,
callers may return results of `html!` directly as responses:
```rust,no_run
use maud::html;