Write as a knowledgeable colleague — clear, direct, and helpful. Use second person ("you") when addressing the reader. Avoid jargon unless the audience is exclusively technical. Keep sentences under 25 words. Use active voice: "Click Settings" not "Settings should be clicked."
| Element | Convention | Example |
|---|---|---|
| Article title | Sentence case — action + subject | Fix VPN timeout errors on macOS |
| Tags | Lowercase, singular, no abbreviations | vpn, macos, network |
| Categories | Max 2 levels — broad then specific | Network > VPN |
Give knowledge managers and content owners a shared set of writing, formatting, and naming standards for their knowledge base. This template defines tone of voice, structure, naming conventions, and quality criteria — so every contributor produces articles that are consistent, searchable, and useful.
Try now in EliumA knowledge base style guide is a reference document that defines the writing standards, formatting rules, and naming conventions for all content in a knowledge base. It ensures that every article — regardless of author — follows the same structure, tone, and quality criteria so readers get a consistent experience.
Without a style guide, knowledge bases become inconsistent within months. One author writes formal paragraphs, another uses bullet lists. Titles follow different conventions. Terminology varies between teams. The result is a knowledge base that looks unprofessional and is hard to search because the same concept has three different names. A style guide prevents this drift by giving every contributor a clear, shared standard to follow.
This template is for teams responsible for knowledge base quality and governance:
The template has two parts: structured metadata fields and the style guide body.
Metadata fields classify the guide:
Style guide body covers every standard:
Capture faster. Describe your organisation’s writing preferences — formal or conversational, technical or accessible — and Elium’s AI generates a first draft of your style guide with tone of voice guidelines, formatting rules, and naming conventions that you refine.
Retrieve smarter. A contributor asks Elium’s AI: “How should I title an article about VPN troubleshooting for remote users?” The AI returns the naming convention from your style guide — format, capitalisation, and keyword placement — so every article follows the same pattern.
A knowledge base with 4,000 articles and hundreds of contributors needs guardrails. Without documented standards, quality degrades as the knowledge base grows — articles become harder to find and less trustworthy. Elium makes governance practical: style guides live alongside the content they govern, contributors reference standards from within their writing workflow, and search ensures the guide itself is always one question away.
VINCI Energies — 97,000 employees across 61 countries — manages over 4,000 articles in Elium with 500+ daily users. At that scale, consistent writing standards are essential. A shared style guide ensures that articles contributed by engineers in France, technicians in Germany, and project managers in Brazil follow the same structure and quality criteria.
Related reading: Read more on our blog
We use cookies to enhance your browsing experience, serve personalized content, and analyze our traffic. By clicking "Accept All", you consent to our use of cookies. You can manage your preferences or learn more in our Privacy Policy. Learn more in our Privacy Policy.
We use different types of cookies to optimize your experience on our website. You can choose which categories you want to allow.
These cookies are essential for the website to function properly. They enable basic functionality such as page navigation and access to secure areas. The website cannot function properly without these cookies.
These cookies help us understand how visitors interact with our website by collecting and reporting information anonymously. This helps us improve our website's performance.
These cookies are used to track visitors across websites. They are used to display ads that may be relevant and engaging for individual users.
These cookies enable enhanced functionality and personalization, such as videos and live chats. They may be set by us or by third-party providers.