Come si può contribuire a questa FAQ Programmatore?

I contributi di ogni tipo sono benvenuti ed incoraggiati. Tutti i contributi saranno certamente apprezzati quando qualcuno in futuro si porrà la domanda, "Come posso fare a...?".

Per creare una nuova FAQ o modificarne una esistente devi essere un utente registrato. Clicca su Log In in alto alla pagina per registrarti.

Se hai delle domande o dei suggerimenti su questa FAQ, contatta [docs@glassfish.java.net]. Puoi registrarti sulla pagina mailing lists di GlassFish.

Metodi suggeriti per contribuire

• • Invia una risposta ad una domanda esistente per cui è richiesta una risposta* (le domande sono elencate nella sezione Developer FAQ Wish List sulla pagina principale delle FAQ). Può darsi tu abbia incontrato un problema che poi sei riuscito a risolvere. Può darsi tu abbia scritto su qualche blog relativamente ad un argomento oppure tu abbia risposto più volte alla stessa domanda all'interno dei forum. Se hai delle conoscenze da condividere, fallo.

• • Invia una nuova domanda per la quale sai anche la risposta.* Prima di tutto assicurati che la FAQ non esista già (se così fosse, leggi il punto successivo). A questo punto chiediti se questa è veramente una domanda che viene posta frequentemente. E' una domanda frequente nelle mailing list? E' una domanda che molta gente si pone (specialmente i nuovi programmatori di GlassFish!) e su cui ha bisogno di aiuto? Se così fosse, aggiungila.

• • Aggiungi delle informazioni ad una FAQ scritta da qualcun altro.* Se hai qualcosa da aggiungere per migliorare una FAQ, sei pregato di farlo. Potrebbe essere un esempio dettagliato (gli esempi fan sempre bene!), una soluzione funzionante dopo una nottata dove niente sembra funzionare, o un trucco interessante che la gente dovrebbe sapere.

Formato della FAQ

Le voci all'interno di una FAQ dovrebbero usare le stesse convenzioni di nomenclatura ed aderire allo stesso formato. Questo è molto importante. Per favore segui le seguenti indicazioni:

• • Usa il prefisso Faq quando scegli il nome di una pagina wiki*, e pensa la rimanente parte del nome breve ma descrittiva. Per esempio, il nome di questa pagina è FaqContributeToDeveloperFAQ.

• • Aggiungi le FAQ nuove nella categoria appropriata.* Se non trovi la categoria nella pagina GlassFish Developer FAQ principale, aggiungila. Devi aggiungere anche una voce corrispondente nella Tabella dei Contenuti della pagina principale in modo che gli altri possano trovare facilmente ciò che tu hai aggiunto. Segui la formattazione delle altre voci presenti in questa pagina principale.

• • Ripeti la tua domanda come intestazione nella pagina della risposta ed accertati che la domanda sia identica a quella presente nella pagina principale FAQ Programmatore.* Per esempio, la domanda Come si può contribuire a questa FAQ Programmatore? è presente sia nella pagina principale GlassFish Developer FAQ sia in testa a questa pagina di risposta. Un esempio di disallineamento che andrebbe corretto è la domanda Come si può contribuire a questa FAQ Programmatore? con la risposta Contribuire a questa FAQ.

• • Utilizza un'intestazione di media grandezza per la domanda che precede la tua risposta* (marcatura !!). Per esempio, Come si può contribuire a questa FAQ Programmatore? in testa a questa pagina ha un testo leggermente più grosso ed un colore diverso. Questo risultato è stato ottenuto utilizzando la marcatura !! di testata.

• • Segui alcune semplici linee guida editoriali.* Il nome GlassFish ha una F maiuscola. Per esempio, GlassFish invece di Glassfish. Il numero di versione è rappresentato con una v minuscola. Per esempio, v2 oppure v3 invece di V2 oppure V3. Inoltre utilizza la v minuscola al posto della parola intera versione. Per esempio, usa v3 invece di versione 3. Questa convenzione non è coerente su tutto il wiki ma andrebbe seguita quando si aggiungono dei contenuti.

Linee guida sul contenuto della FAQ

• • Segui le linee guida sul formato elencate sopra.* La consistenza è importante.

• • Accertati che la FAQ sia focalizzata sul programmatore invece che sull'utente*, orientata verso gli sviluppatori di GlassFish anzichè agli utenti di GlassFish. Per questioni relative agli utenti, vai alla GlassFish User FAQ.

• • Il titolo della tua FAQ deve essere una domanda reale che chiunque potrebbe effettivamente porsi.* Dovrebbe essere breve e puntuale, idealmente non più lunga di una linea e fornire un breve sommario sull'argomento che verrà trattato.

Aggiungere nuove FAQ

1. Clicca Log In in cima alla pagina ed autenticati. Avrai bisogno di creare un'utenza se non ne possiedi già una. Guarda How do I register? per maggiori informazioni sulla registrazione.
2. Clicca GlassFish Developer FAQ sulla sinistra se non sei già su questa pagina. Verrà mostrata la pagina GlassFishDeveloperFAQ.
3. Clicca Edit in fondo alla pagina. Questa opzione Edit è disponibile solo se sei loggato. Guarda Why can't I edit a GlassFish Wiki page? se sei loggato ma l'opzione Edit non è disponibile.
4. Scorri fino alla categoria appropriata (ad esempio Classloaders) e aggiungi la tua domanda alla lista, seguendo il formato utilizzato per le altre domande e fai attenzione alle linee guida esposte sopra. Se non individui una categoria adatta creane una nuova. Importante: Se crei una nuova categoria devi aggiungere anche una voce corrispondente nella Tabella dei Contenuti. Usa lo stesso formato delle altre voci.
5. Guarda l'anteprima delle tue voci, modificale se necessario, quindi salva.
6. Clicca sulla tua domanda sulla lista nella pagina GlassFishDeveloperFAQ ed aggiungi il contenuto nella pagina risultante sull'argomento.
7. Guarda l'anteprima del tuo contenuto, modificalo se necessario, quindi salva.

Modificare FAQ esistenti

1. Clicca Log In in cima alla pagina ed autenticati. Avrai bisogno di creare un'utenza se non ne possiedi già una. Guarda How do I register? per maggiori informazioni sulla registrazione.
2. Clicca GlassFish Developer FAQ sulla sinistra se non sei già su questa pagina. Verrà mostrata la pagina GlassFishDeveloperFAQ.
3. Clicca il collegamento alla FAQ che vuoi modificare. Verrà mostrata la pagina sull'argomento.
4. Clicca Edit in fondo alla pagina. Questa opzione Edit è disponibile solo se sei loggato. Guarda Why can't I edit a GlassFish Wiki page? se sei loggato ma l'opzione Edit non è disponibile.
5. Modifica il contenuto della pagina che viene visualizzata.
6. Guarda l'anteprima dei tuoi cambiamenti, modificali se necessario, quindi salva.