Skip to content
This repository has been archived by the owner on Nov 9, 2020. It is now read-only.

Latest commit

 

History

History
45 lines (30 loc) · 2.78 KB

contribute.md

File metadata and controls

45 lines (30 loc) · 2.78 KB
Raw

Come contribire

Per cominciare a contribuire a questo progetto puoi creare una fork e, dopo aver fatto i cambiamenti che ritieni necessari, puoi mandarci una pull-request, noi ci impegniamo a leggere i tuoi contributi e revisionarli, dopo di che potranno essere integrati nella guida allo sviluppo veloce per Firefox OS.

Siccome questo è un lavoro collaborativo dobbiamo essere molto attenti a uniformare il testo in modo che sia il più possibile privo di problemi quindi ti chiediamo di attenerti ad alcune regole per scriverlo.

Stile, Stile, Stile

Per favore mantieni lo stile di scrittura coerente:

  • Usa *corsivo* invece di _corsivo_
  • Usa **grassetto** invece di __grassetto__
  • * per elementi di una lista invece di -
  • usa http://miosito.com per intero quando aggiungi un link ma escludi www
  • Possibilmente inserisci gli url come un riferimento a fondo pagina, sopratutto se sono molto lunghi
  • è "web", non "Web", a meno che non sia scritto così nel nome di una tecnologia come in "WebSocket"
  • dopo un titolo, sezione, sottosezione si va a capo e si salta un rigo
  • inserisci uno spazio tra # ed il titolo quando scrivi un nuovo paragrafo
  • i nomi dei file vanno in grassetto, index.html
  • la scrittura corretta è "JavaScript"
  • NON CAMBIARE I LINK, L'ORDINE DEI LINK E NON SPOSTARLI un panda rosso muore ogni volta che succede

Contenuti

Questo è un testo per principianti, probabilmente non hanno mai visto HTML e JavaScript, mantieniti ad un livello da principiante e non ti addentrare troppo nel tecnico, una guida per immagini sarà sempre migliore di una serie di comandi da terminale lasciati lì senza spiegazioni.

Cosa manca a questa guida

Per documentare il lavoro che deve ancora essere fatto noi usiamo uno strumento di Github, lo Issue tracker di questa repository. Su questa pagina dividiamo il lavoro per argomenti e chiunque abbia un account su GitHub può commentare, proporre, chiedere chiarimenti.

Prendi spunto da questi argomenti per decidere cosa vuoi scrivere per la nostra guida e lascia un commento per farci sapere che ci stai lavorando.

Ti consiglio di aggiungere ai tuoi messaggi delle commit il numero del problema a cui stai lavorando, ad esempio:

git commit -m "ecco i nuovi screenshots aggiornati alla versione 2.0 di Firefox OS, #22"

In questo modo verranno aggiunte le tue commit al nostro Issue #22, permettendoci di vedere il tuo lavoro.