Difference between revisions of "Help:Author Guidelines for Readability"
Line 1: | Line 1: | ||
==Author Guidelines for Readability== | ==Author Guidelines for Readability== | ||
− | Contributors to | + | Contributors to the ER Wiki are afforded a degree of latitude to create content according to their expertise without compromising higher level technical concepts. |
Even so, a few ground rules are good to have in mind when writing articles so that the wiki appeals to the widest possible audience with a need to practice environmental remediation. | Even so, a few ground rules are good to have in mind when writing articles so that the wiki appeals to the widest possible audience with a need to practice environmental remediation. | ||
Revision as of 16:43, 31 January 2017
Author Guidelines for Readability
Contributors to the ER Wiki are afforded a degree of latitude to create content according to their expertise without compromising higher level technical concepts. Even so, a few ground rules are good to have in mind when writing articles so that the wiki appeals to the widest possible audience with a need to practice environmental remediation.
Please consider these guidelines when writing:
- Avoid or minimize jargon (or at least explain it within the text)
- Spell out acronyms the first time used
- Be concise
- Use active voice
- Simplify for accessibility by readers other than your discipline
- Explain specialized terms
- Explain obscure terms
- Avoid descriptors that don't enhance the meaning (e.g. substantial, significant etc.)
- Speak to an audience level between High School Senior and undergraduate studies