Linee guida per contribuire alla documentazione

Benvenuto in queste Linee guida per contribuire alla documentazione di Moodle. Trova qualche cosa che può essere migliorato nel contenuto, nella grammatica o nella formattazione, e modificalo!

  • Se non lo hai già fatto, esegui prima il login.
  • Considera che tutti i contributi sono rilasciati sotto la GNU General Public License.
  • Da Moodle 1.6 ci sarà un pulsante su ogni pagina che linka pagine in Moodle Docs con lo stesso path delle pagine in Moodle. Puoi vedere ciò già su moodle.org e, per un amministratore, sul Moodle demo site.
  • Considera che i Moodle help files rimarranno in ogni language pack, per cui non è necessario includere il loro testo in questa documentazione.
  • Sei invitato a illustrare la documentazione con screenshots. Guarda la style guide per ulteriori informazioni.
  • Se trovi qualche pagina che va cancellata, scrivi
    {{Deletion}}
    all'inizio della stessa pagina.

Creazione di nuove pagine

  • Sei invitato ad aggiungere pagine per accrescere la documentazione. Basta scrivere il nome della nuova pagina tra due coppie di parentesi quadre
    [[Nome pagina nuova]]
    su una pagina esistente e seguire il link per iniziare a modificare la nuova pagina. In alternativa, si può scrivere nella barra degli indirizzi del browser:
    https://docs.moodle.org/it/Nome_nuova_pagina
    (sostituendo gli spazi con i caratteri di sottolineatura).
  • Scegli nomi pagina brevi e rendi maiuscola solo la prima parola (con poche eccezioni, come la parola Moodle).
  • Nuove pagine della documentazione per gli sviluppatori devono essere aggiunte al Development namespace scrivendo
    Development:
    prima del nome della nuova pagina, cioè
    [[Development:Nome nuova pagina]]
    .
  • Segui la style guide, assicurando in particolare che le nuove pagine abbiano la categoria.
  • I titoli delle pagine potranno cambiare in futuro tramite ridirezione/spostamento di pagine, in funzione della ristrutturazione della documentazione.

Link inter-lingua

  • Sei invitato ad aggiungere link inter-lingua tra pagine scritte in lingue diverse. Basta scrivere, per esempio,
    [[es:Pagina corrispondente in spagnolo]]
    nel MoodleDocs in italiano, o
    [[en:Pagina corrispondente in inglese]]
    nel MoodleDocs in italiano, in fondo alla pagina, sotto ai link di categoria. I link inter-lingua appariranno automaticamente nel blocco "Altre lingue".

Commenti alle pagine

  • Per commenti su una pagina particolare, e/o brevi discussioni, usa la corrispondente pagina di discussione (clicca sul tab discussion). Firma e poni la data ai tuoi contributi scrivendo di seguito quattro caratteri tilde ~~~~.
  • Per discussioni più lunghe sulla documentazione, utilizza il forum Discussion su Using Moodle.