1. Home
  2. Docs
  3. Style Guide
  4. General Writing Principle...
  5. Tone and Voice

Tone and Voice

The tone and voice of our documentation reflect WriteTech Hub’s brand identity. Our tone should be professional yet approachable, conveying authority without being overly formal. Our voice should be consistent across all documentation, ensuring that users have a cohesive experience regardless of the content they are reading.

  1. Professional yet Friendly
    While we maintain a professional tone, our writing should also be welcoming and supportive. Users should feel guided, not intimidated, by our documentation. Avoid overly formal language that can create distance between the writer and the reader. For example, instead of “It is recommended that you proceed as follows,” use “We recommend proceeding as follows.”
  2. Empathetic and User-Focused
    Always keep the user’s perspective in mind. Write with empathy, anticipating questions or concerns they might have. For instance, instead of saying, “You must ensure all fields are filled correctly,” say, “To avoid errors, make sure all fields are filled in correctly.”
  3. Consistency in Voice
    Regardless of who writes the documentation, it should sound like one person wrote it. This consistency in voice fosters a sense of reliability and trust in our content.
  4. Encouraging and Positive
    Use positive language to encourage users. Instead of highlighting what they cannot do, focus on what they can do. For example, instead of “You cannot proceed without completing this step,” say, “Complete this step to proceed.”