mirror of
https://github.com/NixOS/nix.dev.git
synced 2024-10-18 14:32:43 -04:00
expand on which voice to use when
This commit is contained in:
parent
50bfb75f17
commit
6b51983ba6
|
@ -61,7 +61,13 @@ Describe the subject factually and use the imperative voice in direct instructio
|
|||
|
||||
Do not assume a personal relationship with readers, prefer clarity and brevity to emotional appeal.
|
||||
|
||||
Use second person ("you") to refer to the reader and only use "we" to refer to the Nix Community.
|
||||
Use "you" to refer to the reader and only use "we" to refer to the authors.
|
||||
Both should be rarely needed.
|
||||
|
||||
For example:
|
||||
|
||||
> You will have to deploy secrets to the remote machine.
|
||||
> We chose to show the explicit, manual process using `scp` here, but there are various tools to automate that.
|
||||
|
||||
### Be correct, cite sources
|
||||
|
||||
|
|
Loading…
Reference in a new issue