Table of Contents : Il manuale

Il manuale

Benvenuto nella versione beta di Cookbook, la nuova applicazione per la gestione della documentazione di CakePHP. Speriamo che questa nuova applicazione renderà più semplice contribuire alla documentazione, mantenendo un alto livello qualitativo del materiale pubblicato.

Un gigantesco grazie va a AD7six, che ha sponsorizzato la causa di Cookbook, investendo infinite ore di sviluppo e test di questa applicazione.

Come funziona:

  1. Visiti il sito e noti un errore, qualcosa di incompleto, qualcosa di non documentato, o qualcosa che magari è semplicemente scritto male.
  2. Effettui il login in Cookbook con il tuo account Bakery.
  3. Utilizzi la funzionalità di Edit usando il semplice HTML.
  4. Torni il giorno dopo o giù di lì, e le tue modifiche saranno approvate.

Questa applicazione è nuovissima, quidi speriamo che sarete pazienti mentre sistemiamo gli ultimi problemini in attesa della release di CakePHP 1.2.

Come contribuire:

Il nostro principale bisogno è quello di riportare il contenuto da tempdocs.cakephp.org nel Cookbook. Quasi la metà del contentuto è già stato introdotto durante la fase di testing, abbiamo, quindi, avuto un ottimo avvio. Considerate pure di unirvi allo sforzo.

Qualche consiglio:

  • Usate le sezioni esistenti del Cookbook come esempio.
  • Usate <pre> per i blocchi di codice.
  • Usate testo piano o HTML semantico secondo le vostre capacità.
  • Non preoccupatevi troppo dei markup. Tutto quello che sottoporrete verrà sistemato correttamente.

Traduzioni

Scrivetemi o cercatemi su IRC (#cakephp su freenode) per discutere su ogni iniziativa di traduzione che volete prendere in affidamento.

Sto cercando di rendere la documentazione per CakePHP migliore di quanto sia mai stata. Spero che vi unirete a me utilizzando questa applicazione e fornendo aiuto a questo progetto dal quale noi tutti abbiamo così tanto beneficiato.

Cordialmente,

John David Anderson (_psychic_)
CakePHP Documentation