Introducció
Col·laborar en el MDC és tan fàcil com utilitzar el navegador. Si heu emplenat alguna vegada un formulari d'ingrés en una pàgina web o heu fet servir un quadre de text per a escriure un comentari en un bloc, llavors teniu totes les habilitats que es necessiten per a començar. Us convidem a col·laborar escrivint, revisant, o traduint qualsevol dels documents que componen aquest wiki. Si us plau, feu-ho amb esperit col·laboratiu, no us enfadeu si algú demà corregeix o millora les vostres aportacions. Som ací per a escriure la millor documentació possible per al Mozilla. Per això, el treball en equip, l'ajuda mútua i el «bon rotllo» són fonamentals.
Aspectes bàsics
El que segueix és una breu guia sobre la creació i edició de pàgines en els wikis del MDC. Podeu posar en pràctica les vostres habilitats a l'àrea de proves.
El primer pas
Per poder editar cal ser editor, en altres paraules, heu de tenir compte d'usuari del wiki. Per crear un compte, heu d'anar a la pàgina de registre/entrada d'usuaris, emplenar el formulari i enviar-lo. Una vegada hàgiu creat el vostre compte, entrareu automàticament en el sistema i ja podreu editar-hi.
Edició de pàgines
En el menú de la dreta de les pàgines veureu l'opció «edit» (editar). Des d'allà s'accedeix a l'àrea d'edició de la pàgina. Des d'allà poden fer-se les millores que es creguin convenients i previsualitzar-ne els canvis. Si tot està correcte, es prem el botó de desar i llest. Una vegada desada una millora en una pàgina, aquesta s'actualitza immediatament.
Creació d'una pàgina nova
La manera més fàcil de crear una pàgina nova és posar-li un enllaç des de la vostra pàgina d'usuari, i després utilitzar aquest enllaç per a entrar en l'àrea d'edició de la pàgina nova.
Per a entrar en la vostra pàgina d'usuari, feu clic en el vostre nom d'usuari (situat en la barra blava del wiki, en la part superior). Si encara no heu afegit gens a la vostra pàgina d'usuari, entrareu directament en l'àrea d'edició de la pàgina, i podreu afegir els continguts que vulgueu. Crear l'enllaç a la pàgina que voleu afegir és tan simple com escriure el títol de la pàgina tancat amb dobles claudàtors. Un exemple, escrit així: [[Àrea de proves:Açò és un exemple|Açò és un exemple]] es visualitzarà així: Açò és un exemple.
Si la pàgina no existeix, l'enllaç serà de color vermell, si la pàgina ja existeix, l'enllaç serà blau. Si voleu crear una pàgina nova, però el títol que voleu per a la pàgina ja ha estat fet servir, podeu pensar un títol diferent i crear un enllaç amb ell, però plantegeu-vos primer si no seria millor ajudar a corregir i millorar la pàgina que ja existeix.
Per a afegir continguts a la pàgina nova, simplement feu clic a l'enllaç vermell que prèviament vàreu crear i poseu-vos a escriure. Recordeu-vos de fer servir sovint el botó «Mostrar previsualització» (sota àrea d'edició) per a veure com quedarà el vostre treball o «Desa la pàgina» per a desar-la definitivament (feu-ho sovint, si treballeu amb textos extensos), i si el canvi és molt petit marqueu el quadre «Aquesta és una edició menor». A més resulta molt convenient afegir-hi un resum comentant els canvis.
Nom de les pàgines
Per a més informació pel que fa a la creació i nom de les pàgines, consulteu la nostra guia de Noms de les pàgines.
Codi wiki
Si ara mateix feu clic a «edit» (en el menú dret), veureu que el text d'aquesta pàgina conté alguns caràcters especials, per exemple, els signes «==» als costats dels títols, o els enllaços tancats amb dobles claudàtors «[[]]». Aquesta és una forma molt simple d'etiquetar els textos que és específica dels wikis. L'avantatge d'aquest sistema d'etiquetatge és que és molt fàcil d'aprendre, i tendeix a ser bastant indulgent amb els errors.
Tenim una completa guia de referència del llenguatge wiki que podeu fer servir per a conèixer el llenguatge d'etiquetatge amb el qual podreu editar aquestes pàgines.
Guia d'estil
En la Guia d'estil es defineixen les pràctiques preferents a l'hora d'escriure a l'MDC. Si teniu preguntes sobre usos i estils que no són esmentades en ella, us recomanem que tingueu com a referència el llibre d'estil de la Viquipèdia.
Escriptors, revisors i traductors
A continuació uns comentaris orientats específicament a escriptors, revisors i traductors.
Escriptors
En el MDC ens encanten els continguts nous, us animem a escriure articles nous sobre qualsevol temàtica actualment tractada en el wiki. Un contingut nou pot ser un simple comentari, o una complexa i extensa guia de referència de programació. La quantitat dels nous continguts que aportis és la que decidiu.
Si voleu començar un projecte extens, us suggerim que primer ho comentis en la pàgina de discussió de coses per fer, pot ser que ja hi hagi algú més que s'ho estigui plantejant (o hagi començat ja) un projecte similar.
Revisors
Les correccions són sempre benvingudes, en particular les millores o correccions en l'estil d'escriptura, la gramàtica, o l'ortografia. Llegix la Guia d'estil per a més informació. Les revisions i millores tècniques també són necessàries. Si en llegir una pàgina trobeu una errada o un error tècnic (en el codi o en el text), si us plau, corregiu-lo. Si realitzeu un canvi que pugui resultar polèmic, escriviu-ne una nota en la pàgina «de discussió» (l'opció "Discussion" en el menú de la dreta) i indiqueu-ne les raons del canvi.
Traductors
En el MDC català una de les nostres principals necessitats és la traducció dels continguts de la versió anglesa, on en altres llengües, com l'espanyol o el frànces. Per a triar quin document traduir, podeu consultar la categoria Pàgines per traduir, però abans de fer-ho, llegiu Com traduir.
- Projectes locals
- Actualment el MDC disposa de wikis en les següents llengües:
Català, 中文(简体), Deutsch, English, Español, Français, Italiano, 日本語, Nederlands, Polski, Português, 한국어.
Unir-se a la comunitat de l'MDC
El Centre Mozilla per a desenvolupadors és obra d'un gran nombre de voluntaris i sempre s'ajudara a que n'hi hagi més.
Llistes de correu i grups de discussió
- Vegeu els fòrums de l'MDC
- Llista del projecte en anglès
Canal IRC
En anglès: #mdc a irc.mozilla.org.
Líder del projecte
L'MDC està sota la supervisió de Deb Richardson.