Testomgeving

Biedt een testomgeving aan voor elke wijziging, zodat het laagdrempelig is om een review te doen van een wijziging. Laat ook weten waar in testomgeving je moet zijn, en hoe je de wijzigingen kan testen. Zo maak je samen een beter product.

De aanbevolen manier is "branch deployments" als testomgeving.

Branch deployments

Gebruik de bestaande Vercel infrastructuur voor NL Design System voor het maken van branch deployments voor GitHub Pull Requests, voor projecten waarvan de build een statische website of een Node.js server is.

Wanneer iemand een Pull Request maakt, wordt automatisch een testomgeving aangemaakt. De Pull Request ontvangt na enkele minuten automatisch een comment met een linkje naar de testomgeving.

Gebruik waar mogelijk infrastructure-as-code om Vercel te configureren, via de vercel terraform provider in de nl-design-system/terraform repository.

Lokale testomgeving

Gebruik de README.md om instructies te delen om de testomgeving lokaal op te starten. Dit is handig wanneer branch deployments niet beschikbaar zijn. Documenteer in elk geval:

• Vereisten. Bijvoorbeeld installeer Node.js en pmpm of Docker, en gebruik pnpm install.
• Configuratie. Bijvoorbeeld welke environment variables nodig zijn voor de testomgeving.
• Hoe je de testomgeving start. Bijvoorbeeld: pnpm run build en pnpm run start.

Let op: de ontwikkelomgeving die je start met pnpm run dev is niet hetzelfde een testomgeving. De testomgeving moet zoveel mogelijk lijken op de productieomgeving.