Insights

Level: Optimize

UX writing: a verifiable protocol applied to three real Edikka interfaces

Three real interfaces, sixteen replayable checks and one deliberately unresolved result to connect wording, evidence and accessibility.
Estimated reading time:
UX writing: writing clearer and more persuasive interfaces

This is not a list of writing tips. It is a public before-and-after on three Edikka interfaces, where every wording decision is connected to data, an acceptance criterion and replayable evidence.

  • 3 interfaces AI agent test, contact form and article actions.
  • 16 checks Stable UXW identifiers and explicit evidence.
  • 15 satisfied After the dated correction.
  • 1 to test Screen-reader announcement remains open.

Short answer

UX writing becomes verifiable when words match the interface’s actual state.

A label is not useful merely because it reads smoothly. It should name the action, object, next state and confidence level without asking the reader to interpret the system. On a critical interface, that promise must also remain true in the accessible name, error summary, dynamic message and translated edition.

Edikka applied that definition to three public interfaces: the AI agent readiness test, the contact form and this article’s actions. The protocol has sixteen stable checks. Fifteen are satisfied after correction; the sixteenth remains “To test” until a VoiceOver and NVDA retest is published.

Decision rule

Clearer wording is not automatically higher-performing wording. This study infers no conversion, satisfaction or comprehension uplift. It verifies fidelity between words, evidence state, available action and what the machine announces.

Operational definition

What the protocol measures — and what it refuses to invent.

Boundary of Edikka UX writing study v1.0.1
DimensionMeasured hereNot demonstrated
AccuracyThe text matches the data and its reliability level.That readers remember the information better.
ActionThe label names the object, format or next step.That more people click.
AccessibilityAccessible name, error association, focus and programmatic status.Full WCAG or RGAA conformance of the page or site.
ConsistencySummary, detail, report and French edition carry the same decision.A universal editorial preference.

This boundary avoids the common shortcut of turning observable microcopy conformance into proof of commercial effectiveness. User testing or controlled experiments can measure comprehension and task success. These sixteen checks answer a narrower question: does the interface say exactly what its system knows, does and expects?

Edikka method · v1.0.1

Three bases, four statuses, no average that erases a blocking defect.

Controlled vocabulary
FieldAllowed valuesRule
BasisWCAG · interface pattern · evidence integrityEach check names its requirement type; preference is not disguised as a standard.
StatusSatisfied · To correct · To test · Out of scopeNot tested never means satisfied.
SeverityBlocking · High · MediumSeverity does not alter the observed result.
TimeBefore · After · RetestA correction adds to historical evidence; it does not replace it.

The protocol was frozen before the conclusion was written. The same sixteen checks apply to the initial and corrected states. The result is not a score: one blocking failure remains visible even when the other fifteen checks pass.

Public results · 3 September 2026

Nine gaps corrected, six rules retained, one human retest still open.

Before and after by interface
InterfaceInitial stateCorrected stateDecision
AI agent test5 to correct · 1 to test5 satisfied · 1 to testScan quality now governs verdict wording.
Contact form4 satisfied · 2 to correct6 satisfiedTwo summary wordings were corrected; four already-satisfied properties were retained.
Article actions2 satisfied · 2 to correct4 satisfiedTwo generic labels were made precise; two already-satisfied properties were retained.

The third case combines two corrections with two properties that were already satisfied. UXW13 and UXW14 document the labels made precise; UXW15 and UXW16 preserve accessible-name and bilingual consistency. The study separates corrected gaps from retained rules instead of reducing the interface to one global verdict.

Case 01 · Evidence integrity

Case 01 · AI agent test: a cautious verdict can still be wrong.

The test compared Edikka with two competitors. Access42 was readable and scored 42/45 against Edikka’s 40/45. Claude.ai returned a partial 10/45 result explicitly labelled inconclusive. The former interface summarised everything as “Apparent lag, to confirm.” Caution attached to the weak scan contaminated the reliable comparison.

The correction does not seek a more flattering phrase. It separates evidence sets: “Confirmed lag behind 1 competitor; 1 inconclusive result.” The confirmed difference remains two points. The weak result stays visible but can neither create nor erase an advantage.

From data to text in a mixed comparison
LayerBeforeAfter
Reliable subsetPresent in the data, absent from the decision.Drives confirmed rank 2/2 and the −2 gap.
Weak resultDegraded the whole verdict.Counted and excluded from confirmed rank with its reason.
Shareable reportScore without readability quality.Score, quality and reasons remain together.
Next actionReview everything without knowing which scan to repeat.Replay the inconclusive scan; handle the confirmed lag separately.
Before correction: the apparent lag verdict mixes one reliable competitor with an inconclusive result
Before · caution attached to the weak scan erased the confirmed lag.
After correction: the verdict separates a confirmed lag from an inconclusive result
After · both evidence states are named without being merged.
General principle

Caution is not a veil over the whole sentence. It must attach precisely to the uncertain evidence. Good UX writing reduces ambiguity without discarding available information.

Case 02 · Form errors

Case 02 · Contact form: the summary and field should describe the same correction.

On empty submission, the form already identified errors in text, moved focus to the summary, linked back to fields and exposed aria-invalid with aria-describedby. Four useful mechanisms were present. The gap was wording precision: the summary title remained generic and its links sometimes paraphrased the message displayed beside the field.

The corrected edition announces “4 fields to correct before sending your request” and repeats every message exactly. With one failure, the singular form is used. This identity is not cosmetic: it prevents the same problem from carrying two formulations depending on where it is encountered.

Editorial boundary

This case checks wording fidelity across the summary, field and accessible announcement. Accessible forms: errors, focus and lost leads retains the full implementation scope: structure, programmatic associations, data preservation, keyboard navigation and screen-reader testing. This page does not duplicate that technical guide.

Replayable contact-form scenario
StepExpectedEvidence
1. Submit emptyFocus reaches a summary announced as an alert.Visible focus and role inspection.
2. CountThe title states exactly four fields.Compare title, four links and four invalid fields.
3. CompareEvery summary link repeats its field message.Text equality, ignoring punctuation only when meaning is unchanged.
4. CorrectThe message identifies the error and a possible correction.Visible text, aria-describedby and a new retest.
Before correction: generic contact-form error summary
Before · accessible mechanisms existed, but the summary did not quantify the task.
After correction: the summary states four fields and repeats field-level messages
After · count, links and inline errors describe the same correction.

Case 03 · Links and downloads

Case 03 · Article actions: the control should describe the result, not only the intent.

The generic action panel offered a diagnosis and checklist without naming this page’s asset. The new edition prioritises two concrete outputs: “Download the UX writing grid (XLSX)” and “Audit an interface.” The format is visible before activation and the commercial destination announces its scope.

The rewrite preserves what already worked: native links, accessible names containing visible labels, equivalent French intent and a stable analytics name for the download. The change is dated in the changelog so a CTA modification during the MIA-FR observation window is not hidden.

Before correction: generic action panel on the UX writing article
Before · the action existed, but its object remained generic.
After correction: UX writing grid download and interface audit actions
After · object, format and destination are announced before activation.

Open instrument

All sixteen checks, with acceptance criteria and evidence.

The table is generated from the canonical JSON. The XLSX uses the same identifiers, statuses and observations. Any divergence between article and files blocks the migration.

UXW01–UXW06 · 6 checks

AI agent readiness test

Mixed comparison: one readable competitor and one inconclusive competitor.

UXW01 to UXW06 · AI agent readiness test
IDSurfaceCheckAcceptance criterionChangeBasisSeverityEvidence
UXW01agent-readyThe overall verdict only depends on scans that pass the published reliability threshold.An inconclusive result is excluded from the confirmed rank and cannot create or erase a lead or lag.To correct → SatisfiedEvidence integrityBlockingReplayed case: Edikka 40/45, Access42 42/45 reliable, Claude 10/45 inconclusive.
UXW02agent-readyEvery inconclusive result is named and counted.Readers know how many results are excluded and why without opening every scan detail.To correct → SatisfiedEvidence integrityHighGlobal label and per-competitor quality shown together.
UXW03agent-readyThe wording reproduces the actually confirmed gap.The point difference and its direction match the reliable subset.To correct → SatisfiedEvidence integrityHighComparison of public scores with the rendered verdict.
UXW04agent-readyThe report retains each scan's quality, not only its score.Score, reliability level and at most two reasons remain visible in the shareable report.To correct → SatisfiedEvidence integrityHighPublic report generated after the fix.
UXW05agent-readyThe summary, rank and competitor cards tell the same conclusion.No layer shows a raw three-participant rank when the confirmed verdict only compares two.To correct → SatisfiedEvidence integrityHighCross-reading the executive summary, comparison panel and report.
UXW06agent-readyThe dynamically injected verdict is announced without moving focus.The important result is exposed to assistive technology with a useful name, role and context.To test → To testWCAGHighDOM inspection available; human evidence not published.

UXW07–UXW12 · 6 checks

Contact form

Empty submission: four invalid required fields.

UXW07 to UXW12 · Contact form
IDSurfaceCheckAcceptance criterionChangeBasisSeverityEvidence
UXW07contactThe error summary states how many fields need correction.The title uses singular for one field and the exact plural count beyond one.To correct → SatisfiedInterface patternMediumEmpty submission of the contact form.
UXW08contactThe summary and field-associated message use exactly the same correction.The summary link repeats the inline message without a different prefix or rewrite.To correct → SatisfiedInterface patternMediumComparison of summary and first-name field after submission.
UXW09contactEvery error is identified in text and offers an actionable correction.The message does not depend on colour or an icon and states the expected information.Satisfied → SatisfiedWCAGBlockingFirst name, last name, email and project messages.
UXW10contactFocus moves to the summary after an invalid submission.The summary becomes visible, receives focus and can be reviewed immediately.Satisfied → SatisfiedInterface patternHighEmpty submission followed by document.activeElement inspection.
UXW11contactEvery summary entry leads to the relevant field.The link targets the field ID and activation moves focus into that field.Satisfied → SatisfiedInterface patternHighSuccessive activation of the four summary links.
UXW12contactThe invalid field exposes its state and relationship to its message.aria-invalid is true and aria-describedby references the visible message ID.Satisfied → SatisfiedWCAGBlockingDOM inspection of all four invalid fields.

UXW13–UXW16 · 4 checks

UX writing article actions

Choose between downloading the grid and requesting an interface audit.

UXW13 to UXW16 · UX writing article actions
IDSurfaceCheckAcceptance criterionChangeBasisSeverityEvidence
UXW13article-actionsThe primary action names the obtained object or destination.The link remains understandable in its card and does not use a generic diagnosis label for a download.To correct → SatisfiedWCAGHighArticle-specific action panel.
UXW14article-actionsThe file format is announced before activation.The visible label includes XLSX and the download attribute provides a stable filename.To correct → SatisfiedInterface patternMediumVisible wording, download attribute and data-download-name event.
UXW15article-actionsThe accessible name contains the visible label.No aria-label replaces the displayed words with different wording.Satisfied → SatisfiedWCAGHighAccessibility-tree and link-attribute inspection.
UXW16article-actionsFrench and English versions retain the same intent and level of precision.Object, format, destination and promise remain equivalent; only the language changes.Satisfied → SatisfiedEvidence integrityMediumComparison of both action panels.

What the machine announces

Visible words are not enough: name, description, error and status must remain coherent.

Four technical tests bound this method. First, a control’s accessible name contains its visible label, so voice-control users can speak the words they see. Second, an error is identified in text and associated with its field. Third, the summary reaches the error without replacing its inline message. Finally, a dynamically injected result is exposed as a status message when the context change should not move focus.

These tests are necessary, but their DOM presence does not prove the full experience. UXW06 therefore remains “To test”. The next review must publish the operating system, browser, VoiceOver or NVDA version, steps and announcement actually heard. The method prefers an exact incomplete result to a 16/16 inferred from code.

Replay protocol

Reproduce the study without asking Edikka to explain the result.

  1. Download the v1.0.1 XLSX or JSON and keep identifiers UXW01 to UXW16.
  2. Open all three public URLs in an extension-free profile, 1280-pixel width and 100% zoom.
  3. For the AI agent test, replay a case with at least one reliable competitor and one inconclusive result; record scores, quality and verdict.
  4. For contact, submit the empty form; record focus, title, links, inline errors and programmatic associations.
  5. For actions, record label, accessible name, destination, announced format and measurement attribute.
  6. Assign one of four statuses, attach evidence and date the result. Never convert “To test” into “Satisfied” by inference.
  7. After correction, replay the exact scenario. Add the retest without deleting the initial observation.

A third party may use another resolution or assistive technology if it is declared. The result becomes a comparable new observation, not retrospective validation of this one.

Editorial architecture

Continue the analysis without conflating microcopy, accessibility and conformance.

One question, one page

Each resource keeps a distinct purpose.

The UX writing protocol measures interface wording. The following resources own technical implementation, the accessibility foundation and public evidence.

Voluntary limit

Edikka evaluates its own interfaces with a method written by Edikka.

This document is neither an independent ranking, a user study nor a certification. Evidence-integrity criteria are Edikka editorial doctrine; they are not attributed to the W3C. WCAG references apply only to the properties they cover.

The three selected interfaces prioritise states where wording changes a decision, correction or commitment. They do not sample the full site. Screenshots document one context; they do not replace the DOM, source file or retest. Any reproducible objection may enter the changelog with its author and the accepted or rejected correction.

Open resources · CC BY 4.0

Download, cite, challenge.

Recommended citation: Morel, Bertrand (2026). UX writing: protocol applied to three Edikka interfaces, version 1.0.1, Edikka. Creative Commons Attribution 4.0.

Public changelog
DateVersionChange
3 September 2026 · 15:29 CEST1.0.1Corrected a divergence between the public summary and the dataset after reconciling all sixteen checks. The initial distribution is now 4 satisfied and 2 to correct for the contact form, then 2 satisfied and 2 to correct for article actions. Totals, observations and detailed decisions are unchanged.
3 September 2026 · 14:53 CEST1.0Protocol frozen; three interfaces audited; nine gaps corrected; UXW06 kept “To test”; article actions changed and logged during the MIA-FR observation window.

Primary sources

Standards and patterns used.

  1. W3C · Understanding SC 2.4.4: Link Purpose.
  2. W3C · Understanding SC 2.5.3: Label in Name.
  3. W3C · Understanding SC 3.3.1: Error Identification.
  4. W3C · Understanding SC 3.3.3: Error Suggestion.
  5. W3C · Understanding SC 4.1.3: Status Messages.
  6. GOV.UK Design System · Error summary.
  7. GOV.UK Design System · Error message.
Edikka perspective

Interface copy is a rendered state of the system, not decoration placed on top of it.

When evidence changes, wording should change at the same granularity. Accuracy, accessible announcement and action purpose stay separate — and each remains testable.

01Name

State what is known

Attach confidence to the uncertain result, not to every result displayed beside it.

02Connect

Keep every layer coherent

Visible text, accessible name, inline error, summary and report should describe the same state.

03Prove

Publish the unresolved check

A documented “To test” result is more useful than conformance inferred from the DOM.

Article FAQ

Go further on this topic

Additional answers to clarify the key points covered in this article.

10 selected questions View all FAQs

Web solutions designed to perform

Strategy. Design. Code. SEO. AI. Clearer, faster, and more compelling digital experiences.