feat: draft onboarding developers #3339
Conversation
|
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
veslav3
force-pushed
the
feat/onboarding-developers
branch
from
6d07761 to
f329ad1
Compare
| Als organisatie wordt je onderdeel van de community. | ||
| De community ontwikkelt _white-label_ componenten: dat betekent dat je nog je eigen invulling moet geven voor de stijl. Werk je voor een organisatie die al vaker projecten doet met NL Design System, dan is er waarschijnlijk al een thema beschikbaar. Ben je nog nieuw, dan kun je een eigen thema beginnen. | ||
|
|
||
| Een thema bestaat uit design tokens die in de eerste laag het fundament van de huisstijl beschrijven: denk aan kleuren en typografie. In een diepere laag kun je de designkeuzes van specifieke componenten uitwerken. In een thema leg je dus niet alleen de huisstijl vast, maar ook designkeuzes voor alle white-label componenten die je nodig hebt en waarvan de code reeds is ontwikkeld door teams van andere organisaties. |
There was a problem hiding this comment.
"Een thema is opgebouwd uit meerdere lagen. In de eerste laag leg je de basis van de huisstijl vast, zoals kleuren en typografie."
Misschien zo de lagen defineren?
|
|
||
| Een thema bestaat uit design tokens die in de eerste laag het fundament van de huisstijl beschrijven: denk aan kleuren en typografie. In een diepere laag kun je de designkeuzes van specifieke componenten uitwerken. In een thema leg je dus niet alleen de huisstijl vast, maar ook designkeuzes voor alle white-label componenten die je nodig hebt en waarvan de code reeds is ontwikkeld door teams van andere organisaties. | ||
|
|
||
| Speciaal voor thema's van overheidsorganisaties is de [themes repository](http://github.com/nl-design-system/themes) beschikbaar waar je gemakkelijk kunt samenwerken om je eigen thema te publiceren voor interne teams en leveranciers. Het is een handige manier om snel aan de slag te gaan, zonder al te veel onderhoud te moeten doen aan de infrastructuur: het NL Design System kernteam neemt die verantwoordelijkheid. Zo kunnen zelfs teams van overheden en diverse leveranciers samenwerken om een consistente implementatie van de huisstijl te bieden bij alle diensten die de design tokens van NL Design System gebruiken. |
There was a problem hiding this comment.
In plaats van 'het is een handig manier ..."
"Hiermee kun je snel aan de slag zonder zelf de infrastructuur te beheren. Het NL Design System kernteam is verantwoordelijk voor het onderhoud."
Het geeft duidelijker aan dat onderhoud zeker niet je verantwoordelijkheid is
|
|
||
| # Eigen componenten maken voor NL Design System | ||
|
|
||
| Als eerste is het een goed idee om te valideren dat de component die je in gedachten hebt nog niet bestaat binnen NL Design System. |
There was a problem hiding this comment.
Ik zou suggestieve zinsformuleringen vermijden 'Als eerste is het een goed idee..."
"Voordat je begint, is het belangrijk om te controleren of de component die je wilt maken nog niet bestaat binnen NL Design System."
|
|
||
| NL Design System is een verzameling herbruikbare bouwstenen, zoals componenten, patronen en richtlijnen, die je kunt toepassen binnen je eigen development omgeving. | ||
|
|
||
| Als developer heb je waarschijnlijk een specifiek doel om NL Design System te gaan gebruiken. Op deze pagina worden de verschillende aspecten van werken met NL Design System toegelicht, zodat je op de juiste pagina beland voor jouw uitdaging. |
There was a problem hiding this comment.
"Op deze pagina vind je een overzicht van de verschillende manieren waarop je met NL Design System kunt werken, met links naar verdiepende pagina’s per onderwerp."
Benoemt expliciet wat de pagina biedt (overzicht + links)
veslav3
force-pushed
the
feat/onboarding-developers
branch
from
5378a2e to
a791f8e
Compare
|
bouwt door op #3302