Good titles are short but descriptive. They should:
- Accurately summarize the content
- Use words users are most likely to search on
- Be 10 words or less (ideally)
Additional Considerations for Comms
Do not use acronyms in page titles, headings, or subheadings. Exception: Acronyms that are never spelled out, such as IT, can be used in those instances.
Additional Considerations for Knowledge
Use the active voice: Search, Create, Make, etc… for How to articles.
- Don't use How to; just start with an active verb, such as Create, Add, Use, etc..
- Do not start a subject with "How to…"
- Example:
- Reset your Internet ID Password with Technology Help
In our environment, depending on the article type, start the title (called Subject in the TDX environment) with
- [Application] / [System and version number(s)]:
- Incident Model:
- Unit Overview:
- Examples:
- Incident Model: MyU
- Unit Overview: OCR - Office of Conflict Resolution
- TDX Knowledge: Create a Knowledge Base Article
- TDX Major Incident: Communicate with Colleagues and Users
- Canvas: Add an Assignment to Your Course Site
- Windows 10: Update Your Operating System
If an article applies to multiple versions, include the latest two versions in the title.
- Example:
- Drupal Enterprise: Enable the Folwell Theme
Note: TDX automatically generates the title of an article based on the Subject field. It serves as the summary heading for the article and is automatically formatted as a heading 1 (H1). For accessibility, a web page should only have one H1. Therefore, do NOT repeat the title in the TDX body field.
Additional Considerations for Website Content
Do not use acronyms in page titles, headings, or subheadings. Exception: Acronyms that are never spelled out, such as IT, can be used in those instances.