diff --git a/_includes/writing/language.html b/_includes/writing/language.html
index d780ad0..64f0ede 100644
--- a/_includes/writing/language.html
+++ b/_includes/writing/language.html
@@ -11,7 +11,7 @@
Don't use apostrophes for plural abbreviations.
Don't use i.e. or e.g.; they are not localization-friendly.
Active voice
@@ -23,7 +23,7 @@
Bold
Use bold text to draw the reader's eye to key phrases and statements in your email and web content. For product copy or help articles, use bold for static UI elements like menu items, buttons, screen headings, and anything else you want to call attention to.
If you need to bold an element but the UI doesn't support it, for example, in a dialog header or a UI message, you can use italics instead.
-Use italics for fields that might change, like a page name. See italics for more guidelines.
+Use italics for fields that might change, like a page name.
- Yes: Go to General Configuration > User Macros.
- No:Go to the settings page and click Configuration.
@@ -82,7 +82,6 @@
See bold for more information about how to format UI elements.
- - Yes: A JIRA workflow is the set of statuses and transitions that an issue goes through during its lifecycle.
- Yes: According to the 2008 IT Unplugged report, IT is really unplugged!
- Yes: For example, if you create a metric called Time to resolution, other projects can create metrics with that name.
@@ -115,7 +114,7 @@
You don't need to create a list for tasks that have 2 or fewer steps.
To add a new user macro:
- - Go to
> General Configuration > User Macros.
+ - Go to Settings > General Configuration > User Personas.
- Choose Create a User Persona.
- Enter the persona details.
@@ -162,7 +161,7 @@
Style
Five great guidelines for clear, concise writing, courtesy of George Orwell:
- - Don't use a metaphor, simile, or other figure of speech that you see
.
+ - Don't use a metaphor, simile, or other figure of speech that you see.
- Don't use a long word if a shorter one will do.
- If you can omit a word, do it.
- Use active voice.