Stappenplan: Help Wanted
Volg dit stappenplan om een component van alle checkpoints 🚩 te voorzien die nodig zijn voor de 'Help Wanted' status van het Estafettemodel.
Naam bepaald op basis van NL Design System naamgeving
Begin met het bepalen van een naam.
Baseer de naam van de component indien mogelijk, op herkenbare termen uit webstandaarden. Liever termen uit HTML, CSS, SVG en WAI-ARIA dan uit 'UI frameworks' die op het moment populair zijn. We schrijven componenten over het algemeen als enkelvoud en met kapitalen. Bijvoorbeeld 'Accordion' of 'Text Input'.
Kijk voor inspiratie bij:
Zijn er meerdere namen voor de component? Kies de meest gangbare. De andere namen kun je later toevoegen aan de documentatie.
🚩 Checkpoint: Naam
Component kort beschreven
Doel: Vanuit het componentenoverzicht kan men de juiste component uitzoeken.
De beschrijving biedt een samenvattende omschrijving van de component, zodat deze niet met een ander verward kan worden.
Kijk ter inspiratie bij in het componentenoverzicht. Of bij de volgende design systems:
- https://design-system.service.gov.uk
- https://designsystem.digital.gov
- https://spectrum.adobe.com
- https://carbondesignsystem.com
- https://cedar.rei.com
Beschrijf specifiek, kort en bondig wat de definitie is voor de component. We schrijven definities over het algemeen niet langer dan één zin, maar zeker niet meer dan een alinea.
🚩 Checkpoint: Beschrijving
Afbeelding gemaakt om de component visueel duidelijk te maken
Doel: De component is visueel duidelijk.
Om de community letterlijk een beeld te geven van de component voegen we een afbeelding toe. Het kernteam maakt deze in het Figma 'Schetsboek'. Zelf kun je een eigen afbeelding maken, huisstijl maakt niet uit.
🚩 Checkpoint: Afbeelding
Aangemaakt als een GitHub Discussion
Doel: Een plek om input te verzamelen.
We gebruiken Github 'Discussions' van NL Design System om input te verzamelen.
- Start een GitHub Discussion voor de component.
- Vul als titel in:
{naam-component}
. - Vul als beschrijving onderstaande template in en start de GitHub Discussion.
## Naam
{naam-component}
## Beschrijving
{beschrijving-component}
## Ook bekend als (niet verplicht)
{andere namen die je bent tegengekomen toen je de naam bepaalde}
## Gerelateerde componenten (niet verplicht)
{zie hieronder}
## Onderzoek
Gerelateerde componenten
Het kan voorkomen dat andere componenten sterk gerelateerd zijn aan dit component. Denk bijvoorbeeld aan Button en Action group. Dan is het handig om deze componenten naar elkaar te laten verwijzen, indien mogelijk via een link. Noteer gerelateerde componenten als volgt:
codevoorbeeld## Gerelateerde componenten
X, Y, of Z.
🚩 Checkpoint: Discussion URL
Staat in de publieke backlog van NL Design System
Doel: Zichtbaarheid en overzicht creëren zodat componenten niet dubbel worden toevoegd.
We gebruiken 'Issues' in de Github 'Backlog' repository van NL Design System om onze backlog te beheren.
- Maak een 'Issue voor de component.
- Vul als titel in:
{naam-component}
. - Vul als beschrijving onderstaande template in en maak het issue aan.
## Naam
{naam-component}
[Link naar GitHub Discussion]({link-naar-github-discussion})
Selecteer bij 'Labels' het label: Component. Selecteer bij 'Projects' het project: Components - 1 - Help Wanted.