You are here

When writing content for Office of Energy Efficiency and Renewable Energy (EERE) websites and applications, follow these requirements. Also see EERE's web writing best practices.

Plain Language

Always follow the requirements of the Plain Writing Act of 2010.

Introductory Text

Introductory text, or "intro text" is the first 1-2 sentences on a web page. This is indexed by search engines. Additionally, intro text is the first content on the web page, and it helps your readers understand what the page is about.

Energy.gov Summary Text

Websites in the Energy.gov Drupal CMS are required to create summary text for the Energy.gov search engine.

For each page, create a unique, meaningful description of the page's content in the CMS summary text field. It should not be longer than 150 characters.  If the first sentence describes the page content and contains 150 characters, use that in the CMS summary text field.

The Energy.gov search engine displays 150 characters from the CMS summary text field in search results.  Commercial search engines such as Google, Bing, and Yahoo may also display the meta description from the CMS summary text field in search results.

Links and Linking Policy

All links from EERE to any other website must follow DOE's Linking Policy. If you have questions about what sites you are permitted to link to, ask the EERE Web Enterprise Manager.

Link Shortening Services

Shortened URLs are usually used on social media feeds, such as Twitter, where you do not have the ability to embed links.

Do not use link shorteners when:

  • You are creating web content where you can embed the link instead. All links should be embedded when you have the ability to do so.
  • You are creating a print product. Shortened links are not recommended for use in print products. Use Energy.gov redirects to link to Energy.gov URLs; use the full URL for links to other websites.
  • You can use a marketing URL or Energy.gov redirect instead.

The link shortening service you may use is determined by the type of URL you're shortening: