These are the best practices for writing high-quality Web content. These will help you with planning a page, evaluating your approach while you're writing, and reviewing it after you have a draft. Follow the steps below and also use the EERE Content Checklist to ensure that your content meets standards.
Before Writing a Page
- Determine the audience of the page. Who will use the information you want to provide?
- Determine the objective of the page.
- What message should the page convey?
- What does your audience want to accomplish when they visit your page? You may want to make a list of the "top tasks" and ensure that the page allows each task to be completed.
- Determine the scope of the content.
- Define what the page will and will not cover. New content should fulfill a need on EERE. Do not duplicate content that exists elsewhere on EERE. A simple search can help you find similar content on EERE; the EERE Information Architect can provide advice on more in-depth searches.
- Leverage existing EERE content through links, when possible. Write only the content needed by your audience and link to related content already on EERE.
- Check with the EERE Information Architect while writing to ensure that your content is optimized for search.
- Refer to your original objective and plan for the page.
- Refer to the EERE Style Guide when you have questions on style. The following is the hierarchy of style guides used for EERE content. Always refer to the EERE Style Guide first; if it doesn't answer your question, move onto the next resource in this order:
- EERE Style Guide
- The Associated Press Style Book (2006)
- Merriam Webster's Collegiate Dictionary (11th Edition)
- The Chicago Manual of Style (15th Edition)
- Refer to the EERE Content Checklist to ensure that your content meets standards.
- Does the page meet the objective?
- Does the page meet the needs of your audience?
- If you were an outside visitor, could you easily complete your "top tasks" using the content and/or links on this page?