Documentation/Unresolved ZemDomu placeholders

Unresolved ZemDomu placeholders

ZMD018

Detect TODO-ZMD placeholders left by quick fixes so they can be resolved before shipping.

✅ Good

<button aria-label="Close"></button>
<label for="email">Email</label>
<input id="email" type="email">

❌ Bad

<button aria-label="TODO-ZMD"></button>
<label for="TODO-ZMD">TODO-ZMD</label>
<label for="TODO-ZMD">{TODO-ZMD}</label>
<p>TODO-ZMD</p>
<p>{`TODO-ZMD`}</p>
<a href="TODO-ZMD">TODO-ZMD</a>

When: TODO-ZMD appears in text or attribute values

Warning: Unresolved ZemDomu placeholder detected

Solution: Replace TODO-ZMD with real, descriptive content

Why it matters

Accessibility: Placeholder labels and names can confuse assistive technologies and users.

SEO: Placeholder link text and metadata reduce relevance for search engines.

In brief

  • Goal: Replace placeholder text with meaningful labels and content.
  • What to do: Find and replace every TODO-ZMD occurrence.
  • Why: Placeholder values reduce accessibility and signal unfinished work.

Intent

ZemDomu quick fixes insert TODO-ZMD as a reminder to fill in real content. This rule flags remaining placeholders so they do not reach production.

Benefits

  • Avoids shipping placeholder labels or hrefs.
  • Keeps accessible names and metadata meaningful.
  • Highlights unfinished quick-fix output in CI.

Techniques

  • ZMD018: Replace TODO-ZMD placeholders with real content.

HTML Semantics

TODO-ZMD is a marker inserted by ZemDomu quick fixes; leaving it in markup indicates unresolved semantics.

Tips & edge cases

  • Search for TODO-ZMD before release to clean up quick fix output.
  • If the placeholder represents optional content, remove the attribute or element entirely.
  • Use meaningful labels and link text instead of placeholders.

See also