Writing Style Guide
Operating Manual
Browse Operating Manual
Table of Contents
Table of contents
#Purpose
This guide defines how KBY Technologies communicates through written content.
It establishes a consistent editorial voice across every article, report, guide, publication and AI-generated document.
Consistency strengthens trust.
Every piece of content should sound like it belongs to the same organisation, regardless of who or what created it.
#Our Writing Philosophy
We write to improve understanding.
Our writing should:
- Explain before persuading.
- Inform before entertaining.
- Simplify without oversimplifying.
- Respect the reader’s intelligence.
- Deliver practical value.
Good writing removes confusion.
Great writing creates confidence.
#Tone of Voice
The KBY Technologies voice is:
- Professional
- Clear
- Confident
- Objective
- Helpful
- Thoughtful
- Respectful
We avoid sounding corporate, sensational or overly academic.
Our goal is to communicate expertise without creating barriers to understanding.
#Language
All content should use British English.
This includes:
- British spelling.
- British grammar.
- British punctuation.
- British terminology where appropriate.
American spelling should only appear when quoting official product names, commands, APIs or source material.
Consistency matters.
#Clarity
Write for understanding rather than complexity.
Prefer:
- Short sentences.
- Active voice.
- Familiar words.
- Logical structure.
- Clear explanations.
Avoid unnecessary jargon.
Where technical language is essential, explain it clearly.
#Structure
Every publication should follow a logical structure.
Use:
- Descriptive headings.
- Clear introductions.
- Well-organised sections.
- Lists where they improve readability.
- Tables where comparison adds value.
Readers should be able to scan a publication and understand its structure quickly.
#Formatting
Content should:
- Use semantic headings.
- Break long sections into manageable paragraphs.
- Use numbered steps for processes.
- Use bullet points for related information.
- Highlight important information without excessive emphasis.
Formatting should improve readability rather than decoration.
#Objectivity
Write objectively.
Avoid emotional or exaggerated language.
Present evidence before conclusions.
Clearly distinguish:
- Facts.
- Analysis.
- Opinion.
- Recommendation.
Readers should always understand which is which.
#Words and Phrases to Avoid
Avoid unnecessary marketing language and clichés.
Examples include:
- Revolutionary
- Game-changing
- Cutting-edge
- Seamless
- Best-in-class
- Industry-leading
- Leverage
- Synergy
- In today’s fast-paced world
- Needless to say
- Obviously
Choose precise language instead.
Accuracy is more persuasive than exaggeration.
#Reader Focus
Every sentence should benefit the reader.
Before including information, ask:
- Does the reader need this?
- Does it improve understanding?
- Does it help someone make a better decision?
If not, remove it.
Respect the reader’s time.
#Consistency
Use consistent:
- Terminology.
- Capitalisation.
- Units of measurement.
- Dates.
- Formatting.
- Citation style.
Consistency reduces cognitive effort and strengthens professionalism.
#Artificial Intelligence
The same writing standards apply whether content is written by a person or generated with AI.
AI should adopt the KBY Technologies editorial voice.
Human reviewers remain responsible for ensuring every publication meets this guide before release.
#In Practice
Before publishing, ask yourself:
- Is this easy to understand?
- Does every sentence add value?
- Is the tone professional and objective?
- Have unnecessary words been removed?
- Would this sound like every other KBY Technologies publication?
If the answer is no, revise the content before publication.