Skip to content

fix(ux): update texts from ux writing review#1947

Open
michael-smt wants to merge 2 commits into
mainfrom
feat/ux-writing-review
Open

fix(ux): update texts from ux writing review#1947
michael-smt wants to merge 2 commits into
mainfrom
feat/ux-writing-review

Conversation

@michael-smt

@michael-smt michael-smt commented Apr 23, 2026

Copy link
Copy Markdown
Member

Backports the reviewed strings from UX writing English into the default texts.

Updates to docs images, Figma etc. will follow after a initial review of the texts.


Documentation.
Examples.
Dashboards Demo.
Playwright report.

Coverage Reports:

Code Coverage

@michael-smt michael-smt self-assigned this Apr 23, 2026

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates localized strings across a wide range of components to better align with the Siemens UX writing guidelines, emphasizing conciseness and consistent terminology. Feedback was provided to address remaining style guide violations, specifically regarding the use of full sentences on interactive pages, improper capitalization in button labels, and the use of abbreviations with periods. Suggestions were also made to remove superfluous words to ensure the UI text remains as brief and clear as possible.

Comment thread projects/element-ng/chat-messages/si-ai-message.component.ts
Comment thread projects/element-ng/file-uploader/si-file-dropzone.component.ts
Comment thread projects/element-ng/file-uploader/si-file-dropzone.component.ts Outdated
Comment thread projects/element-ng/navbar/si-navbar-primary/si-navbar-primary.component.ts Outdated
Comment thread projects/element-ng/status-bar/si-status-bar.component.ts Outdated
Comment thread projects/maps-ng/src/components/si-map/si-map.component.ts Outdated
Comment thread projects/maps-ng/src/components/si-map/si-map.component.ts Outdated
@michael-smt michael-smt marked this pull request as ready for review April 23, 2026 12:28
@michael-smt michael-smt requested review from a team as code owners April 23, 2026 12:28
@michael-smt michael-smt added the ux Marks all UX related topics (UX team is working on or UX input is required) label Apr 23, 2026

@spike-rabbit spike-rabbit left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@michael-smt this PR has some conflicts and failing pipelines

@michael-smt michael-smt marked this pull request as draft June 11, 2026 11:39
@michael-smt michael-smt force-pushed the feat/ux-writing-review branch from 0975451 to df6d741 Compare June 12, 2026 14:19
@michael-smt michael-smt changed the title feat(ux): update texts from ux writing review fix(ux): update texts from ux writing review Jun 12, 2026
@michael-smt michael-smt force-pushed the feat/ux-writing-review branch 3 times, most recently from 6c121c3 to e7439af Compare June 12, 2026 21:37
@github-actions

github-actions Bot commented Jun 12, 2026

Copy link
Copy Markdown

⬇️ Download VRTs

@michael-smt michael-smt force-pushed the feat/ux-writing-review branch 2 times, most recently from 54c9aab to a589d7f Compare June 12, 2026 23:22
@michael-smt michael-smt marked this pull request as ready for review June 13, 2026 15:47
@michael-smt

Copy link
Copy Markdown
Member Author

Rebased, fixed tests and updated all snapshots from the VRT update pipeline job.

To keep the amount of changes low only reviewed (approved) strings from UX writing are updated.

@michael-smt michael-smt requested a review from spike-rabbit June 13, 2026 15:50
@michael-smt michael-smt force-pushed the feat/ux-writing-review branch 3 times, most recently from b4b9f71 to 87c5e44 Compare June 24, 2026 09:37
@michael-smt michael-smt requested a review from Danisand June 24, 2026 10:00
@michael-smt michael-smt dismissed spike-rabbit’s stale review June 24, 2026 11:29

Rebased, fixed tests and updated all snapshots from the VRT update pipeline job.


await expect(page.getByText('Application Name')).toBeVisible();
const toggler = page.getByLabel('Toggle navigation');
const toggler = page.getByLabel('Show navigation');

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@michael-smt @spike-rabbit Toggle and show have different meaning - then we would need to change it to hide navigation afterwards, no?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A "toggle" is basically a checkbox with a active and inactive state, right? So for a11y one could argue Show navigation is correct as a label for something that semantically resembles this:

  • Show navigation

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yes exactly, the screen reader announces in this case either:

Show navigation expanded / Show navigation collapsed

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ah ok, yeah then this is fair.

@spike-rabbit Do you want to review all the texts here or who should do what to get this in asap?

@michael-smt michael-smt force-pushed the feat/ux-writing-review branch from 87c5e44 to dda343d Compare July 6, 2026 08:37
@michael-smt michael-smt force-pushed the feat/ux-writing-review branch from dda343d to 04304c0 Compare July 6, 2026 09:43
@spike-rabbit spike-rabbit added this to the 51.0.0 milestone Jul 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ux Marks all UX related topics (UX team is working on or UX input is required)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants