The HashiCorp voice reflects our personality and is what we say to our users. Our voice stays consistent across all of our content.
Our tone is how we speak and say things to our users. Tone sets the mood of your writing and can change depending on the type of content you’re creating.
Do
- Be clear, concise, and uncomplicated
- Build trust
- Tell the truth
- Be positive and helpful by using concrete examples
- Use HashiCorp principles where relevant
Don't
- Fluffy, jargon-heavy, salesy, corporate
- Formal, stuffy, stiff, robotic
- Know-it-all, arrogant
- Dull, generic, apathetic
- Vague