Bidra til kodebasen

Så gøy du vil bidra! Å lage et designsystem er et samarbeid, så det kan bli så bra som mulig. Det gjelder også komponentene, og resten av kodebasen. Her kommer en intro til hvordan du kan bidra og hvordan du som produsent kan sette opp designsystemet på din maskin.

Designsystemet er et levende produkt som hjelper oss å utvikle konsistente flater av høy kvalitet. Det er et samarbeidsprosjekt, hvor vi ønsker at det skal være lett å bidra. Om du trenger et komponent, lag et forslag og send inn en pull request. Finner du en feil, lag en oppgave så flere kan bidra. Synes du noe av dokumentasjonen er uforståelig eller mangler eksempler, si ifra eller forbedre den selv.

Hvordan kan jeg bidra?

Det finnes mange måter å bidra på. Her er noen:

  • Lag en komponent
  • Oppdatere dokumentasjon
  • Legg til et eksempel
  • Legg til en prop
  • Gi et forslag til en ny komponent
  • Rapporter en bug
  • Bidra i diskusjoner i utforming av komponenter
  • Gi tilbakemelding om hva som fungerer bra/dårlig med et komponent

Oppdatere dokumentasjon

Vi har skrevet en egen guide her.

Rapporter feil eller ønsker

Om du har oppdaget noen feil eller har forslag og ønsker, legg til en issue. Du finner issues i GitHub her. Ta kontakt på Slack til Håvard Hvassing om du ikke har tilgang.

Utvikle en ny komponent

Før du begynner utviklingen, kan det være lurt å ta en diskusjon på Slack om dette er et komponent som bør være felles eller ikke. Det kan også hende noen allerede har startet arbeid med en lignende komponent, som kan samarbeides med.

Etter å ha avklart en skisse med designere, kan du begynne utvikling.

Du finner en guide til hvordan lage nye react-komponenter her.

Hvordan sette opp designsystemet lokalt?

Du kan finne utvikleroppsett på GitHub. Du trenger først "Read"-tilgang for å se prosjektet, klone det og opprette pull requests. Om du ikke har tilgang til repository eller å lage en pull request, send oss en melding på Slack.

Opprett en pull request

Etter den tekniske implementeringen er ferdig, lag en pull request. Beskriv hva du prøver å oppnå, og gjerne inkluder noen screenshots.

Du trenger ikke å ha noe produksjonsklart for å opprette en pull request; gjerne start en pull request for å lettere sparre rundt arbeidet også.

Etter sparring og tilbakemeldinger vil kjerneteamet publisere endringene dine ved ny release.