Come proporre un nuovo componente

January 23rd, 2008

Se volete proporre un nuovo componente per Zend Framework avete due possibilità:

  1. quella teoria, che consiste nel proporlo in via informale nella mailing list
  2. quella pratica, che consiste nel proporlo ufficialmente nel wiki

Supponendo che il vostro intento sia il secondo e che quindi siate pronti ad affrontare l’iter di una nuova proposta, ecco come procedere passo dopo passo.

Prima di iniziare

Prima di procedere è necessario disporre di un account su JIRA/Confluence.
Tutta la fase progettuale del componente avviene infatti sul wiki pubblico di Zend Framework.

La scrittura della proposta di un nuovo componente può avvenire sia da parte di un membro attivo del team di sviluppo, sia da parte di un qualsiasi altro utente che abbia firmato ed inviato a Zend il modulo CLA.
Una volta che Zend ha ricevuto la vostra Contributor License Agreement, il vostro account su JIRA verrà associato al gruppo zf-framework-dev e verranno abilitati i permessi di scrittura nelle aree dedicate allo sviluppo.

Scrittura della proposta

Ora che avete a disposizione un account di sviluppo, la prima cosa da fare è leggere il materiale disponibile per essere certi di assimilare le linee guida base per la scrittura di una nuova proposta.
Personalmente suggerisco di partire dall’area Contributing to Zend Framework, se ancora non l’avete visitata. Offre tutte le indicazioni generali per sviluppare una libreria conforme con gli standard ed i requisiti essenziali.

Authoring a proposal è senza dubbio il passo successivo. Infine, prima di procedere con la scrittura della vostra proposta, suggerisco di curiosare tra quelle attive per verificare che non ce ne sia già una simile e per prendere spunto su come scrivere al meglio una proposta.

Non abbiate fretta di completare la proposta.
Fornite uno scheletro il più possibile vicino all’idea che avete della classe e fornite quanti più esempi a disposizione per permettere alla community ed al core team di valutare la vostra idea.

Buona scrittura!

Ready for Review

Avete completato la vostra proposta? L’avete riletta? Sicuri?

Bene, allora siete pronti per proporla!
Cambiate le impostazioni della pagina modificando la categoria da New Proposals a Ready for Review e comunicate alla mailing list che il vostro progetto è pronto.

Ora non vi resta che attendere e seguire l’evoluzione della vostra proposta.

In bocca al lupo!

Trackback URI | Comments RSS

Leave a Reply