Revisie 481263 van Beginnen

  • Revisie-identificator: Project:en/Project:Beginnen
  • Revisietitel: Beginnen
  • Revisie-id: 481263
  • Gemaakt:
  • Auteur: Prikzilla
  • Is huidige revisie? Nee
  • Reactie

Inhoud van revisie

{{MDCProjectPagesTOC}}

Het Mozilla Developer Network heeft werkzaamheden die passen bij elk niveau van technische kennis. Je hoeft geen programmeur te zijn of heel veel over technologie te weten. Er zijn werkzaamheden van allerlei niveaus, van eenvoudig (teksten controleren en typefouten corrigeren) tot ingewikkeld (documentatie schrijven voor API's).

MDN heeft een eenvoudige webinterface die iedereen met ervaring met tekstverwerkers bekend zal voorkomen. Jouw hulp is welkom! Het succes van het MDN is gebaseerd op de inzet en samenwerking van een gemeenschap van Mozillianen.

  • Inhoud is belangrijker dan stijl, grammatica en spelling. Is je Engels niet perfect? Maak je geen zorgen! Ken je de  your English is not perfect - don't worry about it! Ken je de stijlgids nog niet van buiten? Geen probleem! Maak je een typefoutje? Dat is geen ramp! Een foutje is snel gecorrigeerd en wijzigingen kunnen snel en eenvoudig worden teruggedraaid.
  • Vraag om hulp en chat met je nieuwe vrienden in de MDN-gemeenschap. De gemeenschap (betaalde medewerkers en vrijwilligers) is blij met je. We zijn dol (DOL!) op nieuwe bijdragers. Als het antwoord op een e-mail of vraag op IRC even op zich laten wachten, bedenk dan dat er veel mensen in veel verschillende tijdzone aan veel verschillende projecten werken. Schroom niet om je vraag nog eens te stellen en/of je vraag aan verschillende mensen tegelijkertijd te stellen. Je vraag wordt gezien en gewaardeerd. Als je niet de antwoorden krijgt die je zoekt, vraag het dan aan MDN-opperhoofd Eric Shepherd. Er is voor ons niets belangrijker dan het ondersteunen van bijdragers.
  • Iedereen kan alles aanpassen. Niemand zou boos moeten worden als je hun inhoud aanpast, zoals jij dat ook niet hoeft te doen als een ander jouw inhoud aanpast (al mag je best vragen waarom iemand bepaalde wijzigingen heeft aangebracht.) Wijzigingen zijn geen kritiek, ze zijn (vrijwel altijd) constructief en bedoeld om iets samen beter te maken.
  • We hebben specialisten voor bepaalde onderwerpen. Als je aan het werk bent op een specifiek onderwerp, kunnen zij je daarin bijstaan.

Snelstartgids

Inloggen

MDN gebruikt Persona voor het inloggen. Make een Persona-account aan en log in bij MDN.

Oefenen

Je kunt naar hartelust oefenen en uitproberen in de Sandbox, het deel van de wiki dat speciaal bedoeld is voor uitproberen, leren en experimenteren.

Een pagina bewerken

  1. Klik op de knop "Bewerken" bovenaan de pagina die je wilt bewerken.
  2. Breng je wijzigingen aan. Klik op "Voorbeeld van wijzigingen bekijken" om te zien hoe de gewijzigde pagina eruit gaat zien.
  3. Klik op "Opslaan en bewerken voortzetten" als je de pagina open wilt houden. Klik op "Wijzigingen opslaan" om de wijzigingen te bewaren en de pagina te sluiten. Klik op "Wijzigingen verwerpen" om terug te keren naar de oorspronkelijke versie van de pagina.

Als de browser zo is ingesteld dat er geen referrer-informatie wordt meegestuurd zul je je wijzigingen niet kunnen opslaan. Je krijgt dan een "Permission Denied"/"Toegang Geweigerd"-foutmelding. Je kunt dat in Firefox oplossen door de {{pref("network.http.sendRefererHeader")}}-instelling op de standaardwaarde te zetten (op dit moment is dat "2").

Een nieuwe pagina aanmaken

Kun je geen goede plek vinden voor het artikel dat je wilt toevoegen? Geen probleem! Zet het ergens neer en wij zorgen ervoor dat het op de goede plek komt te staan of we voegen het in bij andere, bestaande informatie als dat logischer zou zijn. Ook nu verwachten we niet van je dat het helemaal perfect is. We hebben een legertje vrolijke kabouters die graag helpen om je inhoud zo mooi en strak mogelijk te krijgen.

  1. Zet de verwijzing naar je pagina (bij voorkeur ook de paginanaam) op de juiste plek in een bestaande pagina.
  2. Selecteer de paginanaam en klik op het Link invoegen/wijzigen-icoon () in de werkbalk. Het dialoogvenster "Link" dialog wordt geopend, met de geselecteerde tekst al ingevuld in het veld "Article Title Lookup/Link Text".
  3. "/nl/docs/" wordt automatisch toegevoegd in het veld "URL" om aan te geven in welke taal je pagina is toegevoegd. Vul de naam van je pagina in achter "/nl/docs/". (Hier hoort de paginanaam te staan, de linktekst uit stap 1 mag eventueel afwijken.)
  4. Klik op OK om de link naar je pagina te bevestigen.

Als de pagina nog niet bestaat zal de link in rood getoond worden. Als de pagina wel al bestaat, zal de link in blauw getoond worden. Als je een nieuwe pagina wilt toevoegen maar de paginatitel die je bedacht hebt bestaat al, kijk dan eerst even of het misschien zinvoller is om met je informatie de bestaande pagina te bewerken en te verbeteren. Is dat niet het geval, bedenk dat een andere titel voor je pagina en maak een link voor die pagina. Het kan helpen om de richtlijnen voor paginanamen te raadplegen (pagina in het Engels).

Om nieuwe inhoud toe te voegen aan je pagina, klik je eerst op "Wijzigingen opslaan" en daarna op de rode link die je net hebt aangemaakt. Je kunt nu aan de slag op je nieuwe pagina. Klik op "Opslaan en bewerken voortzetten" om je wijzigingen op de pagina tussentijds op te slaan en door te gaan met bewerken. Klik op "wijzigingen opslaan" als je klaar bent.

To create a new page without linking from another page, enter a unique page name in the URL field of your browser. For example, if you enter:

https://developer.mozilla.org/en-US/docs/FooBar

... MDN will create a new page with the title "FooBar" and open the editor so you can add content to the new page.

Wiki markup

Kuma, the Mozilla-developed software the Mozilla Developer Network uses, uses HTML as its markup language for the documentation. If you wish to see or edit the HTML content, you can do so by clicking the "Source" button in the toolbar while in edit mode. Click it again to return to the WYSIWYG editor.

Logging documentation bugs

You can report complex problems by filing a documentation bug. Use these field values:

product
Mozilla Developer Network
component
Documentation requests
URL
The page where you found the problem
Description
As much as you know or have time to describe about the problem and where to find correct information. This can include people ("talk to so-and-so") as well as Web links.

Migrating old documentation

One longer ongoing subproject at the MDN is to migrate all currently existing developer documentation from the mozilla.org web site into the MDN wiki. The procedure is fairly simple:

  1. Pick a document you would like to migrate from the existing content list.
  2. Refer to the page naming guide and decide what the page or pages for that document should be called in the wiki.
  3. Create those pages and migrate the content, marking it up as best you can using the wiki markup reference as a guide.
  4. Delete the item from the existing content list.
  5. Add the item to the needs redirect list.

If you are keen on doing a comprehensive job on this, you will also:

  1. Use our search system to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.
  2. Check for external redirects to the original document, and flag those redirects for deletion by adding the "Junk" tag to them.

Localizing MDN

If you are interested in helping translate the documentation in any of the MDN wikis to another language, simply visit the relevant language's wiki and create or edit pages. See Localization projects for information about current projects and how to start a new project.

Resolving "edit wars" or other conflicts

If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please try to resolve the conflict with the people involved first.

Should no resolution be possible, please bring it to the attention of either (ideally) the MDN mailing list or (as a last resort) the developer documentation lead. Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.

Requesting page deletions

Should you create a page by accident or stumble across a page you think should be deleted, mark it as such by adding the "Junk" tag to it.

Items tagged as Junk are checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.

Note: Please do not delete other content or categories from the pages you flag as "Junk".

Bron van revisie

<p>{{MDCProjectPagesTOC}}</p>
<p>Het Mozilla Developer Network heeft werkzaamheden die passen bij elk niveau van technische kennis. Je hoeft geen programmeur te zijn of heel veel over technologie te weten. Er zijn werkzaamheden van allerlei niveaus, van eenvoudig (teksten controleren en typefouten corrigeren) tot ingewikkeld (documentatie schrijven voor API's).</p>
<p>MDN heeft een eenvoudige webinterface die iedereen met ervaring met tekstverwerkers bekend zal voorkomen. <strong>Jouw hulp is welkom! </strong>Het succes van het MDN is gebaseerd op de inzet en samenwerking van een <a href="/en-US/docs/Project:Community" title="/en-US/docs/Project:Community">gemeenschap</a> van Mozillianen.</p>
<ul>
  <li><strong>Inhoud is belangrijker dan stijl, grammatica en spelling. </strong>Is je Engels niet perfect? Maak je geen zorgen! Ken je de&nbsp; your English is not perfect - don't worry about it! Ken je de <a href="/en-US/docs/Project:MDC_style_guide" title="/en-US/docs/Project:MDC_style_guide">stijlgids</a> nog niet van buiten? Geen probleem! Maak je een typefoutje? Dat is geen ramp! Een foutje is snel gecorrigeerd en wijzigingen kunnen snel en eenvoudig worden teruggedraaid.</li>
  <li><strong>Vraag om hulp en chat met je nieuwe vrienden in de MDN-gemeenschap.</strong> De <a href="/en-US/docs/Project:Community" title="/en-US/docs/Project:Community">gemeenschap</a> (betaalde medewerkers en vrijwilligers) is blij met je. We zijn dol (DOL!) op nieuwe bijdragers. Als het antwoord op een e-mail of vraag op IRC even op zich laten wachten, bedenk dan dat er veel mensen in veel verschillende tijdzone aan veel verschillende projecten werken. Schroom niet om je vraag nog eens te stellen en/of je vraag aan verschillende mensen tegelijkertijd te stellen. Je vraag wordt gezien en gewaardeerd. Als je niet de antwoorden krijgt die je zoekt, vraag het dan aan MDN-opperhoofd <a class="link-mailto" href="mailto:eshepherd@mozilla.com">Eric Shepherd</a>. Er is voor ons <em>niets</em> belangrijker dan het ondersteunen van bijdragers.</li>
  <li><strong>Iedereen kan alles aanpassen.</strong> Niemand zou boos moeten worden als je hun inhoud aanpast, zoals jij dat ook niet hoeft te doen als een ander jouw inhoud aanpast (al mag je best vragen waarom iemand bepaalde wijzigingen heeft aangebracht.) Wijzigingen zijn geen kritiek, ze zijn (vrijwel altijd) constructief en bedoeld om iets samen beter te maken.</li>
  <li><strong>We hebben <a href="/Project:en/Topic_drivers" title="Project:en/Topic_drivers">specialisten voor bepaalde onderwerpen</a>.</strong> Als je aan het werk bent op een specifiek onderwerp, kunnen zij je daarin bijstaan.</li>
</ul>
<h2 id="Snelstartgids">Snelstartgids</h2>
<h3 id="Inloggen">Inloggen</h3>
<p>MDN gebruikt <a href="http://www.persona.org/" title="http://www.persona.org/">Persona</a> voor het inloggen. Make een Persona-account aan en log in bij MDN.</p>
<h3 id="Oefenen">Oefenen</h3>
<p>Je kunt naar hartelust oefenen en uitproberen in de <a href="/en-US/docs/Sandbox" title="Sandbox: An area of the wiki for experiments">Sandbox</a>, het deel van de wiki dat speciaal bedoeld is voor uitproberen, leren en experimenteren.</p>
<h3 id="Een_pagina_bewerken">Een pagina bewerken</h3>
<ol>
  <li>Klik op de knop "Bewerken" bovenaan de pagina die je wilt bewerken.</li>
  <li>Breng je wijzigingen aan. Klik op "Voorbeeld van wijzigingen bekijken" om te zien hoe de gewijzigde pagina eruit gaat zien.</li>
  <li>Klik op "Opslaan en bewerken voortzetten" als je de pagina open wilt houden. Klik op "Wijzigingen opslaan" om de wijzigingen te bewaren en de pagina te sluiten. Klik op "Wijzigingen verwerpen" om terug te keren naar de oorspronkelijke versie van de pagina.</li>
</ol>
<div class="note">
  <p>Als de browser zo is ingesteld dat er geen referrer-informatie wordt meegestuurd zul je je wijzigingen niet kunnen opslaan. Je krijgt dan een "Permission Denied"/"Toegang Geweigerd"-foutmelding. Je kunt dat in Firefox oplossen door de {{pref("network.http.sendRefererHeader")}}-instelling op de standaardwaarde te zetten (op dit moment is dat "2").</p>
</div>
<h3 id="Een_nieuwe_pagina_aanmaken">Een nieuwe pagina aanmaken</h3>
<p>Kun je geen goede plek vinden voor het artikel dat je wilt toevoegen? <strong>Geen probleem!</strong> Zet het ergens neer en wij zorgen ervoor dat het op de goede plek komt te staan of we voegen het in bij andere, bestaande informatie als dat logischer zou zijn. Ook nu verwachten we niet van je dat het helemaal perfect is. We hebben een legertje vrolijke kabouters die graag helpen om je inhoud zo mooi en strak mogelijk te krijgen.</p>
<h4 id="Link_from_an_existing_page">Naar je pagina linken vanaf een bestaande pagina</h4>
<ol>
  <li>Zet de verwijzing naar je pagina (bij voorkeur ook de paginanaam) op de juiste plek in een bestaande pagina.</li>
  <li>Selecteer de paginanaam en klik op het Link invoegen/wijzigen-icoon (<img alt="" src="/files/3810/link-icon.png" style="width: 29px; height: 28px;" />) in de werkbalk. Het dialoogvenster "Link" dialog wordt geopend, met de geselecteerde tekst al ingevuld in het veld "Article Title Lookup/Link Text".</li>
  <li>"/nl/docs/" wordt automatisch toegevoegd in het veld "URL" om aan te geven in welke taal je pagina is toegevoegd. Vul de naam van je pagina in achter "/nl/docs/". (Hier hoort de paginanaam te staan, de linktekst uit stap 1 mag eventueel afwijken.)</li>
  <li>Klik op OK om de link naar je pagina te bevestigen.</li>
</ol>
<p>Als de pagina nog niet bestaat zal de link in rood getoond worden. Als de pagina <em>wel</em> al bestaat, zal de link in blauw getoond worden. Als je een nieuwe pagina wilt toevoegen maar de paginatitel die je bedacht hebt bestaat al, kijk dan eerst even of het misschien zinvoller is om met je informatie de bestaande pagina te bewerken en te verbeteren. Is dat niet het geval, bedenk dat een andere titel voor je pagina en maak een link voor die pagina. Het kan helpen om de <a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">richtlijnen voor paginanamen</a> te raadplegen (pagina in het Engels).</p>
<p>Om nieuwe inhoud toe te voegen aan je pagina, klik je eerst op "Wijzigingen opslaan" en daarna op de rode link die je net hebt aangemaakt. Je kunt nu aan de slag op je nieuwe pagina. Klik op "Opslaan en bewerken voortzetten" om je wijzigingen op de pagina tussentijds op te slaan en door te gaan met bewerken. Klik op "wijzigingen opslaan" als je klaar bent.</p>
<h4 id="New_page_without_link">New page without link</h4>
<p>To create a new page without linking from another page, enter a unique page name in the URL field of your browser. For example, if you enter:</p>
<pre>
https://developer.mozilla.org/en-US/docs/FooBar</pre>
<p>... MDN will create a new page with the title "FooBar" and open the editor so you can add content to the new page.</p>
<h4 id="Wiki_markup">Wiki markup</h4>
<p><a href="https://github.com/mozilla/kuma" title="https://github.com/mozilla/kuma">Kuma</a>, the Mozilla-developed software the Mozilla Developer Network uses, uses HTML as its markup language for the documentation. If you wish to see or edit the HTML content, you can do so by clicking the "Source" button in the toolbar while in edit mode. Click it again to return to the WYSIWYG editor.</p>
<h2 id="Logging_documentation_bugs">Logging documentation bugs</h2>
<p>You can report complex problems by <a class="external" href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Mozilla%20Developer%20Network">filing a documentation bug</a>. Use these field values:</p>
<dl>
  <dt>
    product</dt>
  <dd>
    Mozilla Developer Network</dd>
  <dt>
    component</dt>
  <dd>
    Documentation requests</dd>
  <dt>
    URL</dt>
  <dd>
    The page where you found the problem</dd>
  <dt>
    Description</dt>
  <dd>
    As much as you know or have time to describe about the problem and where to find correct information. This can include people ("talk to so-and-so") as well as Web links.</dd>
</dl>
<h2 id="Migrating_old_documentation">Migrating old documentation</h2>
<p>One longer ongoing subproject at the MDN is to migrate all currently existing developer documentation from the <a class="external" href="http://www.mozilla.org">mozilla.org</a> web site into the MDN wiki. The procedure is fairly simple:</p>
<ol>
  <li>Pick a document you would like to migrate from the <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">existing content</a> list.</li>
  <li>Refer to the <a href="/Project:en/Page_Naming_Guide" title="Project:en/Page_Naming_Guide">page naming guide</a> and decide what the page or pages for that document should be called in the wiki.</li>
  <li>Create those pages and migrate the content, marking it up as best you can using the <a href="/Project:En/MDC_style_guide" title="Project:en/Wiki_Markup_Reference">wiki markup reference</a> as a guide.</li>
  <li>Delete the item from the <a href="/Project:en/Existing_Content" title="Project:en/Existing_Content">existing content</a> list.</li>
  <li>Add the item to the <a href="/Project:en/Needs_Redirect" title="Project:en/Needs_Redirect">needs redirect</a> list.</li>
</ol>
<p>If you are keen on doing a comprehensive job on this, you will also:</p>
<ol>
  <li>Use <a href="/Special:Search" title="Search">our search system</a> to search for any links to the original document in the wiki, then change those links so they point at the new wiki page.</li>
  <li>Check for <a href="/Project:en/External_Redirects" title="Project:en/External_Redirects">external redirects</a> to the original document, and flag those redirects for deletion by adding the "Junk" tag to them.</li>
</ol>
<h2 id="Localizing_MDN">Localizing MDN</h2>
<p>If you are interested in helping translate the documentation in any of the MDN wikis to another language, simply visit the relevant language's wiki and create or edit pages. See <a href="/en-US/docs/Project:Localization_Projects" title="/en-US/docs/Project:Localization_Projects">Localization projects</a> for information about current projects and how to start a new project.</p>
<h2 id="Resolving_.22edit_wars.22_or_other_conflicts">Resolving "edit wars" or other conflicts</h2>
<p>If for whatever reason you end up in an "edit war" on a page, where two or more people are continually and repeatedly making and reverting changes, please try to resolve the conflict with the people involved first.</p>
<p>Should no resolution be possible, please bring it to the attention of either (ideally) the <a href="/Project:en/Community" title="Project:en/Community">MDN mailing list</a> or (as a last resort) the <a href="/User:Sheppy" title="User:Sheppy">developer documentation lead</a>. Other technical experts, writers, and editors will be consulted as required, and their expertise will be used to resolve the problem.</p>
<h2 id="Requesting_page_deletions">Requesting page deletions</h2>
<p>Should you create a page by accident or stumble across a page you think should be deleted, mark it as such by adding the "Junk" tag to it.</p>
<p>Items tagged as <a class="internal" href="https://developer.mozilla.org/en-US/docs/tag/junk" title="Special:Tags?tag=Junk">Junk</a> are checked periodically by wiki administrators and the pages it contains are evaluated and deleted when appropriate.</p>
<div class="note">
  <strong>Note</strong>: Please do not delete other content or categories from the pages you flag as "Junk".</div>
Deze revisie terugzetten