Content
Solvexia's brand communication extends beyond its visual elements to include the style in which content is conveyed. These guidelines are designed to help you maintain a cohesive and consistent tone when writing Solvexia content.
Type of content this is applied
- Letters, messages, or emails
- Marketing material
- Advertisements
- Product interface
- Documentation
- Public documents and resources
- Other written communications
Writing principles
Keep these principles in mind when conveying your messages.
1. Pay attention to detail
One of the signs of professionalism and craftsmanship is attention to detail. Even the smallest grammar mistakes are noticeable. Carefully review your written material, and consider using tools like Grammarly to check for errors.
It is also a great practice to have colleagues review your work and provide feedback.
2. Be consistent and adapt
While trying to keep the voice consistent regardless of the audience or message, it is common to adjust the tone—from serious to empathetic to lighthearted—to suit the context and the reader's state of mind.
Consistency also means using a shared language when talking about a subject. This may include general brand terms and ways we describe our work, product, company and concepts.
3. Keep it simple and clear
Write in a clear, simple way that a 12-year-old can understand. Keep your text straightforward and avoid unnecessary creativity with words and phrases. Consider using tools like Grammarly to check for clarity and consistency.
4. AI helps, but mind it
AI is a helpful tool for refining text and exploring different ways to convey messages. However, it is important to apply its suggestions selectively, ensuring that the writing material remains consistent with Solvexia's principles and voice.
Brand voice
Solvexia brand voice is how we talk to people using the combination of personality, tone and style.
We are certain
We believe we can solve our clients problems of any size and complexity.
Use assertive and confident language. Use statistics, quotes and other proof points where possible. Avoid using tentative words like “might,” “maybe,” or “could.”
Do
The new connector will provide a fast and easy way to integrate your automations in SolveXia with your data in Microsoft OneDrive.
Don't
We believe the new connector will provide a fast and easy way to integrate your automations in SolveXia with your data in Microsoft OneDrive.
We are helpful
Our clients come to us to find solutions and opportunities.
Use friendly, approachable language. Adopt a tone that conveys empathy and a willingness to support customers in their journey. Provide informative and educational content that helps customers understand and solve their problems. Frame your message from the prospective of a solution, not a problem.
Do
Trying to find ways to optimise tedious, error-prone manual reconciliations? This webinar is for you.
Don't
Struggling with tedious, error-prone manual reconciliations? This webinar is for you.
We are professional
Our clients are from the industry with high standards and professional requirements.
Use an authoritative tone that makes SolveXia reliable and trustworthy companion. Pay attention to detail in all written and visual materials.
Do
We are currently experiencing a delay in the project timeline.
Don't
This is totally messed up, we're behind schedule.
We are authentic
We value transparency and genuineness in our people and our clients.
Be open and honest in all communications. Use language that is down-to-earth and relatable, avoiding overly technical jargon when unnecessary. Add a personal touch where appropriate, e.g. “we understand...”. Show that you listen. Ask questions to show attention to detail and willingness to learn and help.
Do
We understand the inconvenience this may have caused and appreciate your patience during this period. The service is back to normal.
Don't
Sorry for inconvenience, the service is back to normal.
Quick checklist
Use this checklist to ensure obvious mistakes are avoided.
- Avoid slang.
- Always capitalize Solvexia correctly.
- Use sentence case; don’t capitalize entire titles or sentences.
- Write in plain English.
- Have someone proofread your text.
- Avoid using “here” or “click here” in calls to action.
- Use active voice.
General content guidelines
Dates and times
When referring to times, use AM and PM, and not any other variation (a.m., A.M., am).
Do
6:30 AM
Don't
6:30am
Don't use ordinal numbers for dates. Use a numeral instead.
Do
2 June
Don't
June second
The positions of the month and day vary by country. To avoid confusion, always spell out the name of the month.
Do
November 11, 2022
Don't
8/11/2022
Acronyms and abbreviations
Don't create acronyms and abbreviations from product or feature names.
Do
Solvexia Reconciliations
Don't
Solvexia Recs
Only use acronyms that your audience is familiar with.
Do
We will send you this report ASAP.
If you have to use an acronym, also spell out the term for clarity.
Do
This option allows you to customize, and Business Intelligence (BI) tools exist on the market, so they don't have to be custom-built. In the healthcare industry, BI tools can automate the generation of patient care reports, improving the efficiency of hospital operations.
Don't introduce acronyms that are used just once.
Do
To maximize the value of automated reports and dashboards, establish clear channels for sharing insights across the organization.
Don't
To maximize the value of Automated Reports (AR) and dashboards, establish clear channels for sharing insights across the organization.
Avoid using acronyms and abbreviations in titles and headings.
Do
Improve your key performance indicators
Don't
Improve your KPIs
Titles
Use sentence casing. Only capitalize the first word of a title, like at the beginning of a sentence, and proper nouns, which include the names of brands, products, and services. This makes content more readable and help readers recognise products and services faster.
Use bold font instead of italics for titles to enhance readability and accessibility.
Forms
Use sentence casing for form titles, labels, and fields. Omit colons and other signs from form labels.
Do
SRS attestation form template
Don't
SRS Attestation Form Template: -->
Form labels should describe the purpose of the field; they are not meant to instruct users to take action.
Do
Rebate summary report
Don't
Upload your rebate summary report here
Emojis
Use emojis at the end of the sentence.
Do
Sales data and rebate rules have been successfully processed ✅.
Don't
✅ Sales data and rebate rules have been successfully processed.
Avoid using uncommon or ambiguous emojis within your context.
Do
Sales data and rebate rules have been successfully processed ✅.
Don't
Sales data and rebate rules have been successfully processed ⚡.
Error messages
Error messages should be human-understandable. Avoid using highly technical language and confusing terms.
Refrain from being humorous and maintain a professional tone.
Do
The run failed to start
Don't
Ooops, the run failed to start
Use plain language and be positive. Don't use technical terms or blame the user.
Do
Enter your email address
Your email must be in a format [email protected]
Don't
You did not add your email
For emails use IETF standard
State it clearly.
Do
Upload a mapping file
Don't
This field cannot be empty
Avoid apologies in error messages.
Do
The file cannot be restored
Don't
Sorry, the file cannot be restored
Punctuation
Titles, headings, labels and buttons should not include punctuation unless necessary. Avoid using exclamation marks.
Do
Drive excellence
Don't
Drive excellence!
Do
Final report has no errors
Don't
Final report has no errors!
Capitalisation
In general, use sentence casing. Only capitalize the first word of a title, like at the beginning of a sentence, and proper nouns, which include the names of brands, products, and services. This makes content more readable and help readers recognise products and services faster.
The exceptions for sentence-casing include the titles of books (including e-books), white papers, and reports.
Do
We help you achieve finance excellence
Don't
We Help You Achieve Finance Excellence
Do not use all uppercase for emphasis.
Do
Integrate with your data
Don't
Integrate with YOUR data
Links and buttons
Link text should be clear and descriptive, and ideally indicate the destination. This helps users decide whether or not to click, and prevents confusion from duplicate links.
Do
Automating the process with finance automation tools ensures you meet these schedules efficiently.
Never say “here” or “click here” in links and buttons.
Do
View summary dashboard
Don't
Click here to view summary dashboard