Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

The Big Bieb sync #1892

Open
8 tasks
jeffreylauwers opened this issue Jan 8, 2025 · 1 comment
Open
8 tasks

The Big Bieb sync #1892

jeffreylauwers opened this issue Jan 8, 2025 · 1 comment
Assignees

Comments

@jeffreylauwers
Copy link
Contributor

jeffreylauwers commented Jan 8, 2025

Er is te lang geen Bieb sync video geweest. Inmiddels is er veel aangepast in de Figma bibliotheek die designers hebben gedupliceerd. Zoals:

  • Tokens die niet in code bestaan todo prefix gegeven.
  • Tokens verwijderd en daarvoor in de plaats Common tokens gekozen én gelinkt aan de component.
  • Er zijn nieuwe componenten bijgekomen.
  • Componenten zijn aangepast in de opzet (bijvoorbeeld Side nav).
  • Alles is met Kapitalen geschreven.
  • Figma Hygiëne is toegepast.
  • Duidelijke splitsing aangebracht.

Alle wijzigingen zijn keurig bijgehouden doormiddel van Comments die beginnen met 'Changelog:...'. Dit zijn er inmiddels meer dan 75.

Een verse installatie lijkt daarom sneller. Maar hoe men dat aan kan pakken wil ik graag uitzoeken.

Acties

  • Situatie van Figma bieb uitvragen bij designers.
  • Situatie zoals deze bij designers kan zijn zo goed mogelijk nagebootst.
  • POC om te zien wat een verse installatie zou betekenen.
  • Tijdens POC meenemen welke wijzigingen enkele designers hebben gedaan en welke scenario's voor hen dus relevant zijn.
  • Overwegingen doorlopen met Rozerin, Robbert en Yolijn.
  • Keuze gemaakt voor vorm van Bieb Sync.
  • Designers informeren over gemaakte keuze.
  • Bieb Sync video maken.
  • Support bieden bij designers die hulp nodig hebben.

Acceptatiecriteria

  • Er is bij designers uitgevraagd in hoeverre zij de Figma bibliotheek gebruiken en of zij aanpassingen hebben gedaan.
  • De Comic Sans bibliotheek is zo neergezet dat deze overeenkomt met een situatie zoals deze zich kan voordoen bij designers
  • Er is een POC uitgevoerd om ervaren wat een verse installatie voor designers zou betekenen.
  • Er is een overwogen keuze gemaakt voor de vorm van de The Big Bieb sync.
  • Er zijn issues aangemaakt voor vervolgacties.
  • Designers zijn geïnformeerd over de gemaakte keuze.
  • De Bieb Sync video is gemaakt.
  • Designers zijn geïnformeerd dat ze om hulp mogen vragen.

Overwegingen

We hebben dit eerder al eens besproken. Toen noteerde ik het volgende:

  - Afmaken Todo tokens doorlopen.
  - Scriptje met acceptatie criteria vanuit Changelog comments.
  - Major 2.0 versie.
  - Werkwijze afspreken voor versiebeheer.

Nummeren we op de cover het versienummer? En plaatsen we dit nummer ook in de naam van de video?

Voorwerk

Ik heb al twee testjes gedaan die relevant zijn.

POC Stappenplan

Situatie creëren zoals deze kan zijn bij een designer die de bibliotheek heeft gedupliceerd.

  • 'Oude' cover terug
  • Een aanpassing in tokens op Brand niveau (bijvoorbeeld geen dieren)
  • Extra icons?
  • Een fictieve 'Local - Comic - Bibliotheek' aanmaken met 2 componenten met enkele tokens en 1 herbruikt component uit huidige bibliotheek.
  • Een fictieve 'Template' file maken met componenten uit Huidige bibliotheek en Local bibliotheek.

Stappenplan

Hieronder houden we bij wat we leren in de vorm van een Stappenplan.

W3C DTCG conventie

  • Nieuwe conventie via Token Studio activeren.
  • Pushen naar GitHub.
  • Binnenhalen bij Local bibliotheek.

Figma Bieb 2.0 dupliceren

  • Figma bieb 2.0 positioneren naast huidige bieb.
  • JSON 2.0 positioneren naast huidige JSON.

Brand en Common

  • TODO: Checken welke wijzigingen er zijn gemaakt in Brand en Common tokens.
  • Na de wijzigingen in Brand en Common kiezen voor 'Apply to Document'.

Components nalopen

  • Alle componenten stuk voor stuk nalopen.
  • 'Gebroken' referenties herlinken.

Figma bieb 2.0 publiceren

  • ...

Local bieb

  • 'Swap library' naar Figma bieb 2.0 binnen lokal bieb.
  • Local bieb koppelen aan JSON 2.0.
  • Tijdelijk Figma bestandje maken en via TS huidige JSON binnenhalen.
  • Tokenset van local component uit huidige JSON kopieren.
  • Tokenset van local component toevoegen aan JSON 2.0.
  • Push naar GitHub.
  • Local bieb publiseren.

Template koppelen

  • Binnen template Swap library een koppelen aan Figma Bieb 2.0.

Huidige bieb uitfaseren

  • Unpublisch huidige bieb.
  • Huidige bieb archiveren.
@Rozerinay
Copy link
Contributor

Mijn gedachtewolk

Rollback-strategie

Is het handig om een plan op te stellen voor het geval de nieuwe installatie onverwachte problemen oplevert? Hoe kunnen designers snel terugkeren naar een vorige versie of situatie als dat nodig is?

Back-up van huidige situatie

Voordat de wijzigingen worden doorgevoerd, moeten we zorgen voor een back-up van de oude bibliotheek en JSON bestanden zodat eventuele problemen snel kunnen worden hersteld.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants