La documentazione è una fase fondamentale dello sviluppo, in particolare di una libreria di componenti UI condivisa e utilizzata da diversi team o persone. Tuttavia è estremamente tedioso ed error-prone mantenerla consistente, corretta ed aggiornata. Uno dei vantaggi dell'utilizzo di Typescript è invece proprio avere codice autodocumentato, che fornisca informazioni sul tipo di dati che il componente può ricevere e fornire. In questo talk verrà spiegato e mostrato cosa sia un Abstract Syntax Tree di un linguaggio, in particolare di Typescript, e come esso possa essere sfruttato per generare automaticamente la documentazione di un set di componenti UI scritti in Angular e Typescript.

Comments

Comments are closed.

Mooolto interessante

Luca Basilico at 03:56 on 17 Jun 2017

Divertente, interessante e preciso. Ottimo.

Molto interessante e presentato bene. Valuterei per la demo la presentazione di uno scenario d'uso più complesso, ad esempio come nei casi in cui è necessario corredare con delle immagini gli elementi della library.