Skip to main content

Getting started with UX writing

Ask AIView as Markdown
Copy a prompt to ask an AI assistant about this page.

The writing style guide provides support for content designers, writers, designers and developers at Siemens. These are the guidelines we use as Siemens to create consistent and clear products within industrial contexts and includes common writing errors to avoid.

Basics​

Dive into the fundamental principles of UX writing, where you'll learn how to create text that enhances user experience by being clear, concise, and user-friendly. This section lays the groundwork for all your UX writing endeavors. Read more

Grammar and vocabulary​

Discover the importance of proper grammar and vocabulary in UX writing. These subchapters will guide you on how to use language effectively to create professional and easily understandable content. Read more: Grammar and Vocabulary

Punctuation​

Master the use of punctuation to improve the readability and comprehension of your text. This section covers the rules and best practices for using punctuation marks to ensure your writing is clear and precise. Read more

Capitalization and proper nouns​

Learn the guidelines for using proper nouns correctly in your text. This subchapter will help you understand when and how to capitalize names, brands, and other specific terms to maintain consistency and professionalism. Read more

Formatting​

Discover how we address formatting themes such as writing addresses, dates, measurements and units, names and titles, and money and currency. This section helps you address common formatting wording issues to enhance overall user efficiency. Read more

Forms and form fields​

Every form should provide clear guidance and immediate feedback to ensure a smooth experience. This section outlines how to use concise form field labels, helper texts, and specific validation messages to help users complete forms effortlessly. Forms and form fields

Explore best practices for writing common menu functions, e.g. logging in and welcoming and onboarding users. This section also includes how to label common UI labels, e.g. buttons, so users can easily navigate workflows. Read more

Messages​

Learn when and how to write all types of messages including warnings, errors, infotips, tooltips and notifications that are helpful and user-friendly. This subchapter provides strategies for communicating issues in a way that guides users towards solutions. Read more

Operational emails​

Explore our guidelines and best practice examples for the most common operational emails in industrial applications. Whether you're managing access requests, assigning workflows, or communicating operational alarms and events, clear and consistent emails are essential. This section covers the UX writing fundamentals to keep operations running smoothly and users well-informed. Read more

Support and resources​

Learn about the UX writer role, how writers work in teams and with stakeholders, and explore the UX writing library and AI resources to build your UX writing skills. Read more