mirror of
https://github.com/bitwarden/help
synced 2025-12-12 14:23:15 +00:00
contributing file
This commit is contained in:
59
CONTRIBUTING.md
Normal file
59
CONTRIBUTING.md
Normal file
@@ -0,0 +1,59 @@
|
|||||||
|
Code contributions are welcome! Please commit any pull requests against the `master` branch.
|
||||||
|
|
||||||
|
## Style Guide
|
||||||
|
|
||||||
|
### Hyperlinks
|
||||||
|
|
||||||
|
Link to definitions of technical terms and topics the average user would find helpful.
|
||||||
|
|
||||||
|
Embed links into names and titles.
|
||||||
|
|
||||||
|
Use unbiased and reputable sources.
|
||||||
|
|
||||||
|
### Vocabulary
|
||||||
|
|
||||||
|
List long names before any abbreviations, even if common.
|
||||||
|
|
||||||
|
Add abbreviations after the long name in parenthesis e.g., Time-base One Time Password (TOTP).
|
||||||
|
|
||||||
|
### Style
|
||||||
|
|
||||||
|
Less is more. Be concise.
|
||||||
|
|
||||||
|
Don't make information difficult to find.
|
||||||
|
|
||||||
|
Use notes, tips and warnings sparingly.
|
||||||
|
|
||||||
|
When giving specific instructions to the user on how to take an action, use a numbered list. e.g., "Change your email", "Delete your account".
|
||||||
|
|
||||||
|
Copy exact syntax when referring to buttons or navigating menus and make **bold**.
|
||||||
|
|
||||||
|
Name what is depicted in parenthesis if buttons have both text and image or just an image. e.g., "Click the Tools tab (Wrench icon)."
|
||||||
|
|
||||||
|
Add code blocks for programmatic commands and examples:
|
||||||
|
|
||||||
|
```
|
||||||
|
bw list items
|
||||||
|
```
|
||||||
|
|
||||||
|
Use inline blocks when referring to commands in description `this is an inline block`.
|
||||||
|
|
||||||
|
Use inline blocks when referring to file formats within a description. e.g., export your data to a `.csv` or `.json`
|
||||||
|
|
||||||
|
When explaining navigation within Bitwarden use `→` to make →. e.g., Go to **Tools** → **Import Data"**
|
||||||
|
|
||||||
|
Use Heading 2 `##` for Section titles.
|
||||||
|
|
||||||
|
Use heading 3 `###` for sub-section titles
|
||||||
|
|
||||||
|
### Images
|
||||||
|
|
||||||
|
Use shapes to highlight areas of focus in screenshots.
|
||||||
|
|
||||||
|
Use default settings in programs. i.e., No colorful themes, standard fonts, etc.
|
||||||
|
|
||||||
|
Exclude items that date the image.
|
||||||
|
|
||||||
|
Exclude personal or company information
|
||||||
|
|
||||||
|
Screenshots will be `.png` format.
|
||||||
Reference in New Issue
Block a user