Come mostrare i design tokens nella documentazione

italia / designers.italia.it

Designers Italia mette a disposizione la conoscenza e gli strumenti per progettare e realizzare servizi pubblici centrati sulle necessità delle persone

https://designers.italia.it

BSD 3-Clause "New" or "Revised" License

53 stars 36 forks source link

Come mostrare i design tokens nella documentazione #905

Open Fupete opened 9 months ago

Fupete commented 9 months ago

Esiste già una discussione sul tema che ti interessa, o su un tema simile?

[X] Ho verificato e non esiste

Cosa

Studiare e applicare soluzioni scalabili e automatizzabili per:

[ ] mostrare i Design Tokens di tutto il design system nel fondamento Design Tokens o in una scheda dedicata
[ ] mostrare i Design Tokens nelle specifiche di design dei singoli componenti

magari partendo dai file json disponibili nella repo /italia/design-tokens-italia?

Perché

Integrare la documentazione per componenti della https://github.com/italia/designers.italia.it/issues/876 con il dettaglio dei tokens semplificherebbe il lavoro di integrazione di questi nei diversi framework di sviluppo esistenti e futuri.

Contesto

No response

Altro

No response

Fupete commented 9 months ago

cc (as a reminder) to @zetareticoli @astagi and me @Fupete

zetareticoli commented 9 months ago

Mostrerei la lista completa dei tokens nella pagina esistente Fondamenti / Design Tokens, magari creando un tab dedicato alla tabella, visto che abbiamo già una parte corposa di documentazione su naming e organizzazione.

Sarei poi per mostrare nelle specifiche di design di ogni componente i tokens utilizzati. Per fare ciò dobbiamo avere un JSON organizzato per componente, possibilmente generato a partire da Figma.

zetareticoli commented 9 months ago

Con @astagi stavamo pensando ad un sistema fatto in precedenza per l'indice dei templates statici del modello comuni (lettura di un JSON e compilazione di pagina html)

Fupete commented 9 months ago

Vedi anche old https://github.com/italia/designers.italia.it/issues/433

Concordo con la lista intera nel fondamento design tokens. Per quelli dei componenti c'è da capire l'effort. In ogni caso va capito anche per prioritizzare gli interventi.