Skip to Main Content
Best Practices for Guides
General Guide Requirements
- Place contact information on first page of guide.
- Use a friendly URL. (Use an underscore for multiple word URLs, e.g. women's_studies or ENGL_100_Doe)
- Provide a brief description under guide title.
- Use appropriate subject heading tags.
- Use default fonts only.
- Use side navigation.
- Organize pages using descriptive titles. (Name pages by content type, e.g. "Government Resources" rather than "Websites."
- Use active verbs.
- Set links to "Open in New Window".
- Create assets rather than inserting links. (Assets can be used across all guides, so if a link changes, you only need to change the asset once, and it will update across guides. Also, assets are part of the link checker. Individual links are not.)
- Use hover text for assets embedded in guides.