Rename Docs
Overview
Learn how to rename docs in real time with the Doc Editor.
Step by step: Rename article
Locate the doc you want to rename in the Sidebar
Click the doc to open the Doc Editor for the page
Rename the doc via the editable title at the top of the
Naming Best Practices
Employ Minimalism
We favor a minimalist and telegraphic style that departs from strict grammatical norms in order to improve findability on search engines. Eliminate articles and possessive pronouns; “Download Product” not “Download the Product Application”.
Prioritize Brevity
Keep entries concise. Limit to two words where possible, focusing on essential action verbs and gerunds. Example: Use "Manage Members" over "Managing Your Workspaces".
Use Imperatives
Write commands in the imperative mood. This direct approach guides users clearly, avoiding ambiguity. Example: "Create issues" instructs more clearly than "Issues can be created".
Action-Centric Focus
Center text around user actions. Emphasize verbs and gerunds, placing user tasks at the forefront. Avoid referencing the user or objects unnecessarily.for your articles to facilitate easy navigation. This consistency aids users in finding the information they need without confusion.
Best Practice Examples
Optimal | |
---|---|
Download Product | How to Download the Product |
Manage Members | Managing Your Workspaces |
Create Issues | Creating Issues in Product |
Edit Settings | How To Edit Your Settings |
Frequently Asked Questions
Renaming a doc in DocsHound updates the title but does not alter the doc's URL, maintaining link integrity.
If you rename a doc by mistake, you can quickly revert to the previous title by following the same renaming steps.
DocsHound allows you to rename docs as needed, with no restrictions on the frequency of name changes.