Sidebar (Table of Contents)

Rename docs

Overview

Learn how to rename docs in real time with the Doc Editor.

Step by step: Rename article

Step-by-step
  1. Locate the doc you want to rename in the Sidebar

  2. Click the doc to open the Doc Editor for the page

  3. 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.