Most German docs were written with `ue`/`ae`/`oe`/`ss` ASCII fallbacks (`fuer`, `aenderung`, `koennen`, `gemaess`) — relic from older toolchain constraints. Replaced 237 occurrences across 38 .md files with proper umlauts and ß so the docs read naturally. Substitutions are constrained to plain prose: fenced code blocks (```...```), inline code spans (`...`), markdown link targets `[..](..)`, and HTML comments are preserved verbatim. Path references like `docs/howto-erste-aenderung.md` keep their original (umlaut-replaced) filenames — only the surrounding prose is normalised. Tool: bin/fix-md-umlauts.py (idempotent — no-op on already-clean files). Re-runnable if ASCII fallbacks creep back in via copy-paste. Doc-link-check + doc-drift-check stay green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
39 lines
1.6 KiB
Markdown
39 lines
1.6 KiB
Markdown
---
|
|
name: starterkit-grid-standards
|
|
description: Standardisierungs-Skill für GridJS-Listen im Starterkit. Verwenden, wenn Listen neu gebaut oder refactored werden sollen (rowInteraction, pageSize, filter drawer, URL-state, accessibility).
|
|
---
|
|
|
|
# Starterkit Grid Standards
|
|
|
|
## Ziel
|
|
|
|
GridJS-Listen projektweit einheitlich, zuganglich und wartbar halten.
|
|
|
|
## Wann verwenden
|
|
|
|
1. Neue Listen mit `initStandardListPage(...)` oder `createServerGrid(...)`.
|
|
2. Refactor von Legacy-Listen.
|
|
3. Review von UX/Accessibility in Listen.
|
|
|
|
## Verbindliche Regeln
|
|
|
|
1. MUST `initStandardListPage(...)` als Standard nutzen (nur begruendete Ausnahmen direkt mit `createServerGrid(...)`).
|
|
2. MUST `rowDblClick.getUrl(...)` für zeilenbezogene Navigation setzen, wenn Row-Navigation vorgesehen ist.
|
|
3. MUST globale `rowInteraction`-Defaults respektieren (Action-Spalte, Enter, Doppelklick-Fallback).
|
|
4. MUST globale `pageSize`-Standards respektieren (`10/25/50/100`, Toolbar-Placement, URL > storage > default).
|
|
5. MUST Filter-Drawer/Chips über den Standard-Contract nutzen, keine parallelen Custom-Patterns.
|
|
6. MUST NOT pro Seite eigene Row-Action-Hacks bauen, wenn der Factory-Contract ausreicht.
|
|
|
|
## Vorgehen
|
|
|
|
1. Ist-Liste gegen `references/list-checklist.md` prüfen.
|
|
2. Fehlende Standards zuerst zentral in der Factory loesen, danach nur minimale Seitenanpassungen.
|
|
3. UI/CSS nur als additive Erweiterung zu bestehenden Komponenten.
|
|
4. Relevante Gates und Browser-Smoke (Keyboard + Console) ausführen.
|
|
|
|
## Referenzen
|
|
|
|
- Checkliste: `references/list-checklist.md`
|
|
- Row Interaction: `references/row-interaction-standard.md`
|
|
- Page Size: `references/page-size-standard.md`
|