diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:42:52 -0500 |
commit | 074785cea106179cb3305637055ab0a009ca74f2 (patch) | |
tree | e6ae371cccd642aa2b67f39752a2cdf1fd4eb040 /files/nl/mdn/contribute/howto | |
parent | da78a9e329e272dedb2400b79a3bdeebff387d47 (diff) | |
download | translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.gz translated-content-074785cea106179cb3305637055ab0a009ca74f2.tar.bz2 translated-content-074785cea106179cb3305637055ab0a009ca74f2.zip |
initial commit
Diffstat (limited to 'files/nl/mdn/contribute/howto')
6 files changed, 681 insertions, 0 deletions
diff --git a/files/nl/mdn/contribute/howto/aanmaken_mdn_account/index.html b/files/nl/mdn/contribute/howto/aanmaken_mdn_account/index.html new file mode 100644 index 0000000000..cc50327400 --- /dev/null +++ b/files/nl/mdn/contribute/howto/aanmaken_mdn_account/index.html @@ -0,0 +1,48 @@ +--- +title: Een account op MDN aanmaken +slug: MDN/Contribute/Howto/Aanmaken_MDN_account +tags: + - Aanmelden + - Beginner + - Documentație + - Gids + - GitHub + - Profiel +translation_of: MDN/Contribute/Howto/Create_an_MDN_account +--- +<div>{{MDNSidebar}}</div><p>Om wijzigingen aan te brengen in de inhoud van MDN is een MDN-profiel nodig. Voor het lezen van en zoeken in de MDN-documentatie hebt u geen profiel nodig. Deze gids helpt u om uw MDN-profiel aan te maken.</p> + +<div class="pull-aside"> +<div class="moreinfo"> +<p><strong>Waarom heeft MDN mijn e-mailadres nodig?</strong></p> + +<p>Het e-mailadres wordt gebruik om uw account te herstellen. Indien nodig kan het beheer van MDN contact met u opnemen over uw account of uw activiteit op de site.</p> + +<p>Daarnaast kunt u zich aanmelden voor notificaties (bijvoorbeeld <a href="https://developer.mozilla.org/en-US/docs/MDN/Contribute/Howto/Watch_a_page">wanneer bepaalde pagina's worden aangepast</a>) en berichten (bijvoorbeeld als u zich hebt aangemeld voor het beta-testteam en u nieuwe e-mails wilt ontvangen over nieuwe functies die moeten worden getest).</p> + +<p>Het e-mailadres wordt nooit getoond op MDN en wordt alleen gebruikt overeenkomstig ons <a href="https://www.mozilla.org/privacy/websites/">privacybeleid</a>.</p> + +<p> </p> + +<div class="note">U ontvangt <em><strong>geen</strong></em> berichten of notificaties van MDN als u inlogt op MDN via GitHub en u daar een "noreply"-e-mailadres gebruikt.</div> +</div> +</div> + +<ol> + <li>Op MDN bevindt zich bovenaan elke pagina een knop <strong>Aanmelden met</strong>. Door de muisaanwijzer erboven te houden (of door hem aan te raken op een mobiel toestel) verschijnt er een lijst met authenticatiemethoden die worden ondersteund door MDN.</li> + <li>Selecteer een methode om in te loggen. Op dit moment is alleen GitHub beschikbaar. Als u GitHub selecteert, zal een link naar uw profiel op GitHub worden weergegeven op uw openbare profielpagina op MDN.</li> + <li>Volg de aanwijzingen van GitHub om uw account te verbinden met MDN.</li> + <li>Als de authenticatiedienst u laat terugkeren naar MDN, wordt u gevraagd om een gebruikersnaam en een e-mailadres in te voeren. <em>De gebruikersnaam wordt openbaar getoond om u te prijzen voor uw werk. Gebruik geen e-mailadres als gebruikersnaam.</em></li> + <li>Klik <strong>Creëer mijn MDN-profiel</strong>.</li> + <li>Als het e-mailadres dat u hebt ingevoerd bij stap 4 niet hetzelfde is als het e-mailadres dat u gebruikt bij de authenticatiedienst, controleer dan uw e-mail en klik op de link in de bevestigings-e-mail die we u sturen.</li> +</ol> + +<p>Dat is alles! U hebt nu een MDN account en kunt onmiddellijk beginnen met het bewerken van pagina's!</p> + +<p>U kunt bovenaan elke pagina van MDN klikken op uw naam om uw openbaar profiel te zien. Daar vandaan kunt u op <strong>Bewerken</strong> klikken om uw profiel te veranderen of iets toe te voegen aan uw profiel..</p> + +<p> </p> + +<div class="note"> +<p>Nieuwe gebruikersnamen mogen geen spaties of het karakter "@" bevatten. Denk eraan dat uw gebruikersnaam openbaar wordt getoond om u te prijzen voor uw werk.</p> +</div> diff --git a/files/nl/mdn/contribute/howto/een_redactionele_beoordeling_geven/index.html b/files/nl/mdn/contribute/howto/een_redactionele_beoordeling_geven/index.html new file mode 100644 index 0000000000..38785c1f26 --- /dev/null +++ b/files/nl/mdn/contribute/howto/een_redactionele_beoordeling_geven/index.html @@ -0,0 +1,57 @@ +--- +title: Een redactionele beoordeling geven +slug: MDN/Contribute/Howto/Een_redactionele_beoordeling_geven +tags: + - Documentație + - Gids + - Hoe kan ik + - MDN-Meta + - Redactionele beoordeling +translation_of: MDN/Contribute/Howto/Do_an_editorial_review +--- +<div>{{MDNSidebar}}</div> + +<div>{{IncludeSubnav("/nl/docs/MDN")}}</div> + +<p class="summary"><strong>Redactionele beoordelingen</strong> bestaan uit het corrigeren van typefouten en spelling, grammatica, gebruik of tekstuele fouten in een artikel. U hoeft geen taalexpert te zijn om waardevolle bijdragen te doen aan de technische documentatie van MDN, maar artikelen hebben nog steeds controlewerk en moeten worden proefgelezen. Dit wordt in een redactionele beoordeling gedaan.</p> + +<p><span class="seoSummary">Dit artikel beschrijft hoe u een redactionele beoordeling kunt geven, wat ervoor zorgt dat de inhoud op MDN accuraat is.</span></p> + +<dl> + <dt>Wat houdt de taak in?</dt> + <dd>Controlewerk (‘copy-editing’) en proeflezen (‘proof-reading’) van artikelen die zijn gemarkeerd als artikelen die een redactionele beoordeling nodig hebben.</dd> + <dt>Waar dient dit te worden gedaan?</dt> + <dd>Binnen bepaalde artikelen die zijn gemarkeerd als artikelen die een redactionele beoordeling nodig hebben.</dd> + <dt>Wat dient u te weten om de taak te vervullen?</dt> + <dd>U dient goede vaardigheden op het gebied van Nederlandse grammatica en spelling te hebben. Een redactionele beoordeling zorgt ervoor dat de grammatica, spelling en het woordgebruik juist en logisch zijn, en dat de <a href="/nl/docs/MDN/Contribute/Guidelines/Writing_style_guide">MDN-schrijfstijlgids</a> wordt gevolgd.</dd> + <dt>Wat zijn de stappen om dit te doen?</dt> + <dd> + <ol> + <li>Kies een artikel voor beoordeling: + <ol> + <li>Ga naar de lijst van <a href="/nl/docs/needs-review/editorial">artikelen die een redactionele beoordeling nodig hebben</a>. Deze vermeldt alle pagina’s waarvoor een redactionele beoordeling is aangevraagd.</li> + <li>Klik op het artikel om de pagina te laden.<br> + <strong>Merk op: </strong>Deze lijst wordt automatisch maar niet regelmatig gegenereerd, waardoor er artikelen in de lijst verschijnen die geen redactionele beoordeling meer nodig hebben. Als het artikel dat u hebt geselecteerd <em>geen</em> vak weergeeft waarin 'Dit artikel heeft een redactionele beoordeling nodig' staat, sla het artikel dan over en kies een andere.</li> + <li>Klik op de artikelkoppeling om de pagina te laden.</li> + </ol> + </li> + <li>Lees het artikel en let goed op typefouten, spelling, grammatica of gebruiksfouten. Aarzel niet om naar een andere pagina te gaan als de eerste die u koos niet geschikt voor u is.</li> + <li>Als er geen fouten zijn, hoeft u het artikel niet te bewerken om het als beoordeeld te markeren. Zoek naar het veld voor ‘snelle beoordeling’ in de linkerzijbalk van de pagina:<br> + <img alt="Schermafbeelding van het zijbalkveld voor het beoordelingsverzoek" src="https://mdn.mozillademos.org/files/15668/redactionele_beoordeling.png" style="height: 146px; width: 318px;"></li> + <li>Deselecteer het vakje <strong>Redactioneel</strong> en klik op <strong>Opslaan</strong>.</li> + <li>Als u fouten vindt die dienen te worden gecorrigeerd: + <ol> + <li>Klik boven in de pagina op de knop <strong>Bewerken</strong>; dit brengt u naar de <a href="/nl/docs/MDN/Contribute/Editor">MDN-editor</a>.</li> + <li>Corrigeer eventuele typefouten en spelling, grammatica of gebruiksfouten die u tegenkomt. U hoeft niet alles te corrigeren om nuttig te zijn, maar zorg ervoor dat het verzoek voor redactionele beoordeling actief blijft als u niet helemaal zeker weet of u een volledige controle van het hele artikel hebt gedaan.</li> + <li>Voer onder in het artikel een <strong>Revisieopmerking</strong> in; zoiets als ‘<em>Redactionele beoordeling: typefouten, grammatica en spelling gecorrigeerd</em>’. Dit laat andere medewerkers en website-editors weten wat u hebt gewijzigd en waarom.</li> + <li>Deselecteer het vakje <strong>Redactioneel</strong> onder <strong>Beoordeling nodig?</strong> Dit bevindt zich net onder de sectie Revisieopmerking van de pagina.</li> + <li>Klik op de knop <strong>Publiceren</strong>.</li> + </ol> + </li> + </ol> + + <div class="note"> + <p>Mogelijk zijn uw wijzigingen niet meteen zichtbaar na het opslaan; er kan een vertraging zijn bij het verwerken en opslaan van de pagina.</p> + </div> + </dd> +</dl> diff --git a/files/nl/mdn/contribute/howto/een_technische_beoordeling_maken/index.html b/files/nl/mdn/contribute/howto/een_technische_beoordeling_maken/index.html new file mode 100644 index 0000000000..119e15a9d2 --- /dev/null +++ b/files/nl/mdn/contribute/howto/een_technische_beoordeling_maken/index.html @@ -0,0 +1,56 @@ +--- +title: Een technische beoordeling geven +slug: MDN/Contribute/Howto/Een_technische_beoordeling_maken +tags: + - Beoordeling + - Documentație + - Gids + - MDN Meta +translation_of: MDN/Contribute/Howto/Do_a_technical_review +--- +<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/nl/docs/MDN")}}</div> + +<p class="summary"><strong>Een technische beoordeling</strong> bestaat uit het beoordelen van de technische nauwkeurigheid en volledigheid van een artikel, en het corrigeren hiervan als het nodig is. Als een schrijver van een artikel iemand anders wil vragen om de technische inhoud van een artikel te controleren, klikt diegene op het vakje met de naam 'Technische beoordeling' tijdens het bewerken. Vaak neemt een schrijver contact op met een specifieke technicus om de tekst te laten beoordelen, maar iedereen met technische kennis kan dit doen.</p> + +<p><span class="seoSummary">Dit artikel beschrijft hoe een technische beoordeling kan worden gedaan, die helpt te zorgen dat de inhoud op MDN nauwkeurig is.</span></p> + +<dl> + <dt>Wat is de taak?</dt> + <dd>Het beoordelen en corrigeren van artikelen op technische nauwkeurigheid en volledigheid.</dd> + <dt>Waar moet dit worden gedaan?</dt> + <dd>In specifieke artikelen die zijn gemarkeerd als het behoeven van een <a href="/nl/docs/needs-review/technical">technische beoordeling</a>.</dd> + <dt>Wat moet u weten om de taak te kunnen uitvoeren?</dt> + <dd> + <ul> + <li>Vakkundige kennis over het onderwerp van het artikel dat u beoordeelt. Als het lezen van het artikel u geen nieuwe kennis bijbrengt, kunt u zichzelf beschouwen als een expert.</li> + <li>Hoe u een wiki-artikel op MDN kunt bewerken.</li> + </ul> + </dd> + <dt>Stappenplan</dt> + <dd> + <ol> + <li>Kies een artikel om te beoordelen: + <ol> + <li>Ga naar de lijst met pagina's die een <a href="/nl/docs/needs-review/technical">technische beoordeling</a> nodig hebben. Op deze lijst staan alle pagina's waar technische beoordelingen voor zijn aangevraagd.</li> + <li>Kies een pagina met een onderwerp waar u bekend mee bent.</li> + <li>Klik op het artikel om de pagina te laden.</li> + </ol> + </li> + <li>Lees het artikel, waarbij u goed let op de technische details: Is het artikel correct? Mist er iets? Aarzel niet om naar een andere pagina te gaan als de eerste die u koos niet bij u past.</li> + <li>Als er geen fouten zijn hoeft u het artikel niet te bewerken om het als beoordeeld te markeren. Zoek naar het vak 'snelle beoordeling' aan de linkerkant van de pagina. Dit gele vak geeft alle beoordelingen weer die in behandeling zijn. Hier kunt u een beoordeling als voltooid markeren. Als er om een technische beoordeling is gevraagd, ziet dat er als volgt uit:<br> + <img alt="Screenshot van een vak aan de linkerkant van de pagina, waarin de beoordelingen staan die moeten worden uitgevoerd en waar markeringen kunnen worden gewijzigd." src="https://mdn.mozillademos.org/files/15667/technische_beoordeling.png" style="height: 145px; width: 317px;"></li> + <li>Verwijder de selectie van het vakje <strong>Technisch</strong> en klik op <strong>Opslaan</strong>.</li> + <li>Als u fouten vindt die moeten worden gecorrigeerd is het ook mogelijk om de status van de beoordelingsaanvraag te wijzigen in de editor. U kunt dat als volgt doen: + <ol> + <li>Klik op de knop <strong>Bewerken</strong> bovenaan de pagina om de pagina te bewerken. Hiermee gaat u naar de <a href="/nl/docs/MDN/Contribute/Editor">editor van MDN</a>.</li> + <li>Herstel alle informatie die niet correct is, en/of voeg belangrijke informatie toe die mist.</li> + <li>Vul een <strong>revisieopmerking</strong> onderaan het artikel. Dit is een kort bericht dat beschrijft wat u hebt gedaan, zoals '<em>Technische beoordeling voltooid.</em>' Als u informatie hebt gecorrigeerd, kunt u dat noemen in uw opmerking, bijvoorbeeld '<em>Technische beoordeling en parameterbeschrijvingen hersteld.'</em> Hierdoor weten andere medewerkers en websitebewerkers wat u hebt gewijzigd en waarom. U kunt ook noemen of er specifieke stukken waren waarvoor u zich niet deskundig genoeg voelde om het te beoordelen.</li> + <li>Verwijder de selectie van het vakje <strong>Technisch</strong> onder <strong>Beoordeling nodig?</strong> onder het gedeelte van de pagina waarin u een revisieopmerking kunt schrijven.</li> + <li>Klik op de knop <strong>Publiceren</strong>.</li> + </ol> + </li> + </ol> + + <p>Gefeliciteerd! U hebt uw eerste technische beoordeling gedaan! Bedankt voor uw hulp!</p> + </dd> +</dl> diff --git a/files/nl/mdn/contribute/howto/index.html b/files/nl/mdn/contribute/howto/index.html new file mode 100644 index 0000000000..9dde7488b1 --- /dev/null +++ b/files/nl/mdn/contribute/howto/index.html @@ -0,0 +1,14 @@ +--- +title: Doe-het-zelfgidsen +slug: MDN/Contribute/Howto +tags: + - Landing + - MDN + - MDN Meta +translation_of: MDN/Contribute/Howto +--- +<div>{{MDNSidebar}}</div><div>{{IncludeSubnav("/nl/docs/MDN")}}</div> + +<p>Deze artikelen verstrekken gidsen die u stap voor stap helpen met het bereiken van specifieke doelen tijdens het bijdragen aan MDN.</p> + +<p>{{LandingPageListSubpages}}</p> diff --git a/files/nl/mdn/contribute/howto/tag/index.html b/files/nl/mdn/contribute/howto/tag/index.html new file mode 100644 index 0000000000..d8a523d18f --- /dev/null +++ b/files/nl/mdn/contribute/howto/tag/index.html @@ -0,0 +1,432 @@ +--- +title: How to properly tag pages +slug: MDN/Contribute/Howto/Tag +translation_of: MDN/Contribute/Howto/Tag +--- +<div>{{MDNSidebar}}</div><p>One important feature of MDN that helps users find content is the <strong>article tag</strong>. Each page can be tagged with zero or more tags <span style="line-height: 1.572;">(preferably at least one)</span><span style="line-height: 1.572;"> to help categorize the content. <span class="seoSummary">There are many ways tags are used to help organize information on MDN; this page will help you learn how to best tag pages to help information be organized, sorted, and located by readers.</span></span></p> +<p>For a guide to the user interface for editing tags on pages, see the <a href="/en-US/docs/MDN/Contribute/Editor/Basics#The_tags_box">tagging section</a> in our editor guide.</p> +<p>Note that proper use of tags is important; we are increasingly using automation to generate lists of content, landing pages, and cross-linking of articles. Failure to properly tag articles as indicated below can prevent articles from being listed correctly.</p> +<h2 id="Ways_tags_are_used_on_MDN">Ways tags are used on MDN</h2> +<p>There are several ways tags get used on MDN:</p> +<dl> + <dt> + Categorization</dt> + <dd> + What type of document is it? Is it a reference? A tutorial? A landing page? These can be used when filtering searches, so they're really important!</dd> + <dt> + Topic identification</dt> + <dd> + What topic does the article cover? Is it about an API? The DOM? Graphics? These, too, are important, because they can be used as filters on searches.</dd> + <dt> + Technology status</dt> + <dd> + What's the status of the technology? Is it non-standard? Obsolete or deprecated? Experimental?</dd> + <dt> + Skill level</dt> + <dd> + For tutorials and guides, how advanced is the material covered by the article?</dd> + <dt> + Document metadata</dt> + <dd> + The writing community often needs a way to track information about pages in need of specific kinds of work. This is done using tags.</dd> +</dl> +<h2 id="Tag_type_guide">Tag type guide</h2> +<p>Here's a quick guide to the types of tags and possible values for them.</p> +<h3 id="Category">Category</h3> +<p>Tagging an article with one of these categories will help automatically constructed landing pages, table of contents pages, and the like be more accurately built. These terms will also be used by our new search system, eventually, to let the user locate reference or guide information by their choice.</p> +<p>The following category names are standard tagging terms used on MDN.</p> +<dl> + <dt> + <code>{{Tag("Intro")}}</code></dt> + <dd> + The article provides introductory material about a topic. In theory there should be only one of these per technology area.</dd> + <dt> + <code>{{Tag("Featured")}}</code></dt> + <dd> + The article is a high-importance article that should be featured in a special way on landing pages; this must be used sparingly. Only three or fewer of these should exist in any documentation area.</dd> + <dt> + <code>{{Tag("Reference")}}</code></dt> + <dd> + The article contains reference material about an API, element, attribute, property, or the like.</dd> + <dt> + <code>{{Tag("Landing")}}</code></dt> + <dd> + The page is a landing page.</dd> + <dt> + <code>{{Tag("Guide")}}</code></dt> + <dd> + The article is a how-to or guide page.</dd> + <dt> + <code>{{Tag("Example")}}</code></dt> + <dd> + The article is a code sample page, or has code samples. This shouldn't be used for very one-liner "syntax examples" but actual snippets of useful code, or for full usable samples.</dd> +</dl> +<h3 id="Topic">Topic</h3> +<p>By identifying the article's topic area, you can also help to generate better search results as well as landing pages and other navigational aids.</p> +<p>While there's some room for flexibility here as new topic areas are identified, we try to keep these to the names of APIs or technologies. Some useful examples:</p> +<ul> + <li><code>{{Tag("HTML")}}</code></li> + <li><code>{{Tag("CSS")}}</code></li> + <li><code>{{Tag("JavaScript")}}</code> (notice the capital "S"!)</li> + <li><code>{{Tag("Document")}}</code></li> + <li><code>{{Tag("DOM")}}</code></li> + <li><code>{{Tag("API")}}</code> for each interface, method and property.</li> + <li><code>{{Tag("Method")}}</code> for each method of an API</li> + <li><code>{{Tag("Property")}}</code> for each property of an API</li> + <li><code>{{Tag("Graphics")}}</code></li> + <li><code>{{Tag("Firefox OS")}}</code></li> + <li><code>{{Tag("Gecko")}}</code></li> + <li><code>{{Tag("XUL")}}</code></li> + <li><code>{{Tag("XPCOM")}}</code></li> + <li><code>{{Tag("SVG")}}</code></li> + <li><code>{{Tag("WebGL")}}</code></li> + <li><code>{{Tag("Element")}}</code></li> + <li><code>{{Tag("Node")}}</code></li> + <li><code>{{Tag("Tools")}}</code></li> + <li><code>{{Tag("Web")}}</code></li> +</ul> +<p>In general, the name of an interface that has a number of related pages, such as <a href="/en-US/docs/Web/API/Node" title="/en-US/docs/Web/API/Node">Node</a> (which has many pages for its various properties and methods) makes a good topic identification tag, as does the name of an overall technology or technology type. A page about WebGL might be tagged with <code>Graphics</code> and <code>WebGL</code>, for example, while a page about the {{HTMLElement("canvas")}} element might be tagged <code>HTML</code>, <code>Element</code>, <code>Canvas</code>, and <code>Graphics</code>.</p> +<h3 id="Technology_status">Technology status</h3> +<p>To help the reader understand how viable a technology is, we use tags to label pages as to what the status of the technology's specification is. This isn't as detailed as actually explaining what the spec is and where in the specification process the technology is (that's what the Specifications table is for), but it will help the reader judge, at a glance, whether using the technology described in the article is a good idea or not.</p> +<p>Here are possible values for these tags:</p> +<dl> + <dt> + <code>{{Tag("Non-standard")}}</code></dt> + <dd> + Indicates that the technology or API described on the page is not part of a standard, but is considered stable in the browser or browsers that do implement it. If you don't use this tag, the assumption is made that the article covers something that's standard. The compatibility table on the page should clarify which browser(s) support this technology or API.</dd> + <dt> + <code>{{Tag("Deprecated")}}</code></dt> + <dd> + The technology or API covered on the page has been marked as deprecated in the specification, and is expected to eventually be removed, but is generally still available in current versions of browsers.</dd> + <dt> + <code>{{Tag("Obsolete")}}</code></dt> + <dd> + The technology or API has been deemed obsolete and has been removed (or is actively in the process of being removed) from all or most current browsers.</dd> + <dt> + <code>{{Tag("Experimental")}}</code></dt> + <dd> + The technology is not standardized, and is an experimental technology or API that may or may not ever become part of a standard.</dd> + <dt> + <code>{{Tag("Needs Privileges")}}</code></dt> + <dd> + The API requires privileged access to the device on which the code is running.</dd> + <dt> + <code>{{Tag("Certified Only")}}</code></dt> + <dd> + The API only works in certified code.</dd> +</dl> +<p>Regardless of the use of these tags, you should be sure to include a <a href="/en-US/docs/Project:Compatibility_tables" title="/en-US/docs/Project:Compatibility_tables">compatibility table</a> in your article!</p> +<h3 id="Skill_level">Skill level</h3> +<p>The skill level tag type is only used for guides and tutorials (that is, pages tagged <code>Guide</code>). It's used to help users whittle down tutorials based on their familiarity level with a technology, for example. There are three values for this:</p> +<dl> + <dt> + <code>{{Tag("Beginner")}}</code></dt> + <dd> + Articles designed to introduce the reader to a technology they've never used or have only a passing familiarity with.</dd> + <dt> + <code>{{Tag("Intermediate")}}</code></dt> + <dd> + Articles for users that have gotten started with the technology but aren't experts.</dd> + <dt> + <code>{{Tag("Advanced")}}</code></dt> + <dd> + Articles about stretching the capabilities of a technology and of the reader.</dd> +</dl> +<h3 id="Document_metadata">Document metadata</h3> +<p>The writing community uses tags to label articles as requiring specific types of work. Here's a list of the ones we use most:</p> +<dl> + <dt> + <code>{{Tag("junk")}}</code></dt> + <dd> + The article needs to be deleted.</dd> + <dt> + <code>{{Tag("NeedsContent")}}</code></dt> + <dd> + The article is a stub, or is otherwise lacking information. This tag means that someone should review the content and add more details and/or finish writing the article.</dd> + <dt> + <code>{{Tag("NeedsExample")}}</code></dt> + <dd> + The article needs one or more examples created to help illustrate the article's point. These examples should use the <a href="/en-US/docs/Project:MDN/Contributing/How_to_help/Code_samples" title="/en-US/docs/Project:MDN/Contributing/How_to_help/Code_samples">live sample system</a>.</dd> + <dt> + <code>{{Tag("NeedsLiveSamples")}}</code></dt> + <dd> + The article has one or more examples that need to be updated to use the <a href="/en-US/docs/Project:MDN/Contributing/How_to_help/Code_samples" title="/en-US/docs/Project:MDN/Contributing/How_to_help/Code_samples">live sample system</a>.</dd> + <dt> + <code>{{Tag("NeedsUpdate")}}</code></dt> + <dd> + The content is out of date and needs to be updated.</dd> + <dt> + <code>{{Tag("l10n:exclude")}}</code></dt> + <dd> + The content is not really worth localizing and will not appear on localization status pages.</dd> + <dt> + <code>{{Tag("l10n:priority")}}</code></dt> + <dd> + The content is important and should be marked as a priority for MDN translators. Shows up in an extra priority table on localization status pages.</dd> +</dl> +<h3 id="Web_Literacy_Map">Web Literacy Map</h3> +<p>The <a href="https://webmaker.org" rel="external">WebMaker</a> project, through the <a href="https://webmaker.org/literacy" rel="external">Web Literacy Map</a>, has defined a set of tags to qualify the various competencies and skills recommended to get better at reading, writing and participating on the Web. We use them on MDN to help our users to find the best resources to suit their needs:</p> +<dl> + <dt> + {{Tag("Navigation")}}</dt> + <dd> + The articles provides information on how to browse the web.</dd> + <dt> + {{Tag("WebMechanics")}}</dt> + <dd> + The article provides information on how the web is organized and how it's working.</dd> + <dt> + {{Tag("Search")}}</dt> + <dd> + The article provides information on how to locate information, people and resources via the web.</dd> + <dt> + {{Tag("Credibility")}}</dt> + <dd> + The article provides information on how to critically evaluate information found on the web.</dd> + <dt> + {{Tag("Security")}}</dt> + <dd> + The article provides information on how to keep systems, identities, and content safe.</dd> + <dt> + {{Tag("Composing")}}</dt> + <dd> + The article provides information on how to create and curate content for the web.</dd> + <dt> + {{Tag("Remixing")}}</dt> + <dd> + The article provides information on how to modify existing web ressources to create something new.</dd> + <dt> + {{Tag("DesignAccessibility")}}</dt> + <dd> + The article provides information on how to create universally effective communications through web ressources.</dd> + <dt> + {{Tag("CodingScripting")}}</dt> + <dd> + The article provides information on how to code and/or create interactive experiences on the web.</dd> + <dt> + {{Tag("infrastructure")}}</dt> + <dd> + The article provides information which help understanding the Internet technical stack.</dd> + <dt> + {{Tag("Sharing")}}</dt> + <dd> + The article provides information on how to create resources with others.</dd> + <dt> + {{Tag("Collaborating")}}</dt> + <dd> + The article provides information on how to work with each other.</dd> + <dt> + {{Tag("Community")}}</dt> + <dd> + The article provides information on how to get involved in web communities and understanding their practices.</dd> + <dt> + {{Tag("Privacy")}}</dt> + <dd> + The article provides information on how to examine the consequences of sharing data online.</dd> + <dt> + {{Tag("OpenPracticies")}}</dt> + <dd> + The article provides information on how to help keep the web universally accessible.</dd> +</dl> +<h2 id="Putting_it_all_together">Putting it all together</h2> +<p>So, with these different types of tags, you assemble them together to get the full set of tags for a page. A few examples:</p> +<dl> + <dt> + A tutorial about WebGL for beginners</dt> + <dd> + Appropriate tags would be: <code>WebGL</code>, <code>Graphics</code>, <code>Guide</code>, <code>Beginner</code></dd> + <dt> + Reference page for the {{HTMLElement("canvas")}} element</dt> + <dd> + This should be tagged with <code>Canvas</code>, <code>HTML</code>, <code>Element</code>, <code>Graphics</code> <code>Reference</code></dd> + <dt> + A landing page for Firefox OS developer tools</dt> + <dd> + This should be tagged with <code>Tools</code>, <code>Firefox OS</code>, <code>Landing</code></dd> +</dl> +<h2 id="Tagging_and_search_filters">Tagging and search filters</h2> +<p>The upcoming search filter implementation, which will let users restrict the results of their searches based on criteria they specify, will rely on proper tagging of pages on MDN. Here's a table of the various search filters and which tags they look for.</p> +<div class="note"> + <p><strong>Note:</strong> If multiple tags are listed under "Tag name," that means any one or more of those tags need to be present for the article to match.</p> +</div> +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Filter group</th> + <th scope="col">Search filter name</th> + <th scope="col">Tag name</th> + </tr> + </thead> + <tbody> + <tr> + <th>Topic</th> + <td>Open Web Apps</td> + <td>{{Tag("Apps")}}</td> + </tr> + <tr> + <th> </th> + <td>HTML</td> + <td>{{Tag("HTML")}}</td> + </tr> + <tr> + <th> </th> + <td>CSS</td> + <td>{{Tag("CSS")}}</td> + </tr> + <tr> + <th> </th> + <td>JavaScript</td> + <td>{{Tag("JavaScript")}}</td> + </tr> + <tr> + <th> </th> + <td>APIs and DOM</td> + <td>{{Tag("API")}}</td> + </tr> + <tr> + <th> </th> + <td>Canvas</td> + <td>{{Tag("Canvas")}}</td> + </tr> + <tr> + <th> </th> + <td>SVG</td> + <td>{{Tag("SVG")}}</td> + </tr> + <tr> + <th> </th> + <td>MathML</td> + <td>{{Tag("MathML")}}</td> + </tr> + <tr> + <th> </th> + <td>WebGL</td> + <td>{{Tag("WebGL")}}</td> + </tr> + <tr> + <th> </th> + <td>XUL</td> + <td>{{Tag("XUL")}}</td> + </tr> + <tr> + <th> </th> + <td>Marketplace</td> + <td>{{Tag("Marketplace")}}</td> + </tr> + <tr> + <th> </th> + <td>Firefox</td> + <td>{{Tag("Firefox")}}</td> + </tr> + <tr> + <th> </th> + <td>Firefox for Android</td> + <td>{{Tag("Firefox Mobile")}}</td> + </tr> + <tr> + <th> </th> + <td>Firefox for Desktop</td> + <td>{{Tag("Firefox Desktop")}}</td> + </tr> + <tr> + <th> </th> + <td>Firefox OS</td> + <td>{{Tag("Firefox OS")}}</td> + </tr> + <tr> + <th> </th> + <td>Mobile</td> + <td>{{Tag("Mobile")}}</td> + </tr> + <tr> + <th> </th> + <td>Web Development</td> + <td>{{Tag("Web Development")}}</td> + </tr> + <tr> + <th> </th> + <td>Add-ons & Extensions</td> + <td>{{Tag("Add-ons ")}}|| {{Tag("Extensions")}} || {{Tag("Plugins")}} || {{Tag("Themes")}}</td> + </tr> + <tr> + <th> </th> + <td>Games</td> + <td>{{Tag("Games")}}</td> + </tr> + <tr> + <th>Skill level</th> + <td>I'm an Expert</td> + <td>{{Tag("Advanced")}}</td> + </tr> + <tr> + <th> </th> + <td>Intermediate</td> + <td>{{Tag("Intermediate")}}</td> + </tr> + <tr> + <th> </th> + <td>I'm Learning</td> + <td>{{Tag("Beginner")}}</td> + </tr> + <tr> + <th>Document type</th> + <td>Docs</td> + <td><em>This will restrict the search to docs content, leaving out Hacks and other MDN content.</em></td> + </tr> + <tr> + <th> </th> + <td>Demos</td> + <td><em>This will include Demo Studio content in the search results.</em></td> + </tr> + <tr> + <th> </th> + <td>Tools</td> + <td>{{Tag("Tools")}}</td> + </tr> + <tr> + <th> </th> + <td>Code Samples</td> + <td>{{Tag("Example")}}</td> + </tr> + <tr> + <th> </th> + <td>How-To & Tutorial</td> + <td>{{Tag("Guide")}}</td> + </tr> + <tr> + <th> </th> + <td>Developer Profiles</td> + <td><em>This will include developer profiles from the MDN site in the search results.</em></td> + </tr> + <tr> + <th> </th> + <td>External Resources</td> + <td><em>This is something the dev team will need to figure out.</em></td> + </tr> + </tbody> +</table> +<h2 id="Tagging_problems_you_can_fix">Tagging problems you can fix</h2> +<p>There are several types of problems with tags you can help fix:</p> +<dl> + <dt> + No tags</dt> + <dd> + All articles should have at least one tag, and usually more than one. Generally, at a minimum, articles should have at least a "<a href="/en-US/docs/Project:MDN/Contributing/Tagging_standards#Category" title="/en-US/docs/Project:MDN/Contributing/Tagging_standards#Categories">category</a>" tag and a "<a href="/en-US/docs/Project:MDN/Contributing/Tagging_standards#Topic" title="/en-US/docs/Project:MDN/Contributing/Tagging_standards#Topic">topic</a>" tag. Often other tags are appropriate as well, but if you can help us ensure that at least these are present, you'll be a documentation hero!</dd> + <dt> + Tags that don't follow our tagging standards</dt> + <dd> + We have a <a href="/en-US/docs/Project:MDN/Contributing/Tagging_standards" title="/en-US/docs/Project:MDN/Contributing/Tagging_standards">Tagging standards</a> guide that explains how we use tags, including lists of appropriate tags to use on various types of documentation. Ideally, all articles should follow these standards, so if you see a page whose tags don't do so, please fix it!</dd> + <dt> + Incorrect tags</dt> + <dd> + If you're looking at an article about HTML and it's got the "JavaScript" tag on it, that's probably wrong! Similarly, if an article is about Mozilla internals but has the "Web" tag on it, that's probably wrong too. Remove these tags (and, if missing, add the right ones). This type of problem includes misspelled tags. "JavaScript" or "Javascript" for example (the latter actually will match, since tags are case-insensitive, but it's just not right!).</dd> + <dt> + Missing tags</dt> + <dd> + If an article has some tags, but not all of the appropriate ones, feel free to add more. Maybe you're looking at a page in the JavaScript reference, which is correctly tagged with "JavaScript" but has no other tags. Since it's a reference page, this should also have the "Reference" tag. You're invited to add it!</dd> + <dt> + Tag spam</dt> + <dd> + This insidious beast is the most revolting tag problem of all: some Web vermin has deposited its droppings in the tags for a page, leaving a page with tags like "Free warez!" or "Hey I was browsing your site and wanted to ask you if you could help me solve this problem I'm having with Flash crashing all the time". These need to be deleted posthaste!</dd> +</dl> +<p>If you see one (or more) of these problems, you can help by <a href="/en-US/docs/Project:MDN/Contributing/Getting_started#Logging_into_MDN">logging into MDN</a>, then clicking the Edit button at the top right of the MDN window. Once the editor loads up, scroll down to the bottom of the page, where you'll see the tag box. For more details on the tagging interface, see "<a href="/en-US/docs/Project:MDN/Contributing/Editor_guide#The_tags_box" title="/en-US/docs/Project:MDN/Contributing/Editor_guide#The_tags_box">The tags box</a>" in the <a href="/en-US/docs/Project:MDN/Contributing/Editor_guide" title="/en-US/docs/Project:MDN/Contributing/Editor_guide">MDN editor guide</a>.</p> diff --git a/files/nl/mdn/contribute/howto/taggen_javascript_pagina/index.html b/files/nl/mdn/contribute/howto/taggen_javascript_pagina/index.html new file mode 100644 index 0000000000..ce57acb2f4 --- /dev/null +++ b/files/nl/mdn/contribute/howto/taggen_javascript_pagina/index.html @@ -0,0 +1,74 @@ +--- +title: JavaScript-pagina’s taggen +slug: MDN/Contribute/Howto/Taggen_JavaScript_pagina +tags: + - Guide + - Howto + - JavaScript + - MDN Meta +translation_of: MDN/Contribute/Howto/Tag_JavaScript_pages +--- +<div>{{MDNSidebar}}</div><p class="summary"><strong>Taggen</strong> bestaat uit het toevoegen van meta-informatie aan pagina’s, zodat gerelateerde inhoud kan worden gegroepeerd, bijvoorbeeld in het zoekhulpmiddel.</p> + +<dl> + <dt><strong>Waar moet dit worden gedaan?</strong></dt> + <dd>Binnen specifieke <a href="/nl/docs/Web/JavaScript/Doc_status#No_tags">JavaScript-gerelateerde pagina’s zonder labels</a>.</dd> + <dt><strong>Wat dient u te weten om de taak uit te voeren?</strong></dt> + <dd>Basiskennis over programmeren met JavaScript, zoals weten wat een methode of een eigenschap is.</dd> + <dt><strong>Wat zijn de stappen om het te doen?</strong></dt> + <dd> + <ol> + <li>Kies een van de pagina’s in de lijst hierboven.</li> + <li>Klik op de artikelkoppeling om de pagina te laden.</li> + <li>Klik zodra de pagina is geladen op de knop <strong>BEWERKEN</strong> bovenaan het artikel; hierdoor komt u in de MDN-editor.</li> + <li>Op zijn minst dient het label <code>JavaScript</code> te worden toegevoegd. Mogelijke andere labels om toe te voegen zijn: + <table class="standard-table"> + <thead> + <tr> + <th scope="col">Label</th> + <th scope="col">Pagina’s om het op te gebruiken</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>Method (Methode)</code></td> + <td>methoden</td> + </tr> + <tr> + <td><code>Property (Eigenschap)</code></td> + <td>eigenschappen</td> + </tr> + <tr> + <td><code>prototype (prototype)</code></td> + <td>prototypen</td> + </tr> + <tr> + <td>Object type name (type objectnaam)</td> + <td>methoden van een object; String.vanCharCode dient bijvoorbeeld het label <code>String</code> te bevatten.</td> + </tr> + <tr> + <td><code>ECMAScript6</code> en <code>Experimental (ECMAScript6 en experimenteel)</code></td> + <td>functies toegevoegd in een nieuwe ECMAScript-versie</td> + </tr> + <tr> + <td><code>Deprecated (afgeschaft)</code></td> + <td>afgeschafte functies (waarvan het gebruik wordt afgeraden, maar die nog steeds worden ondersteund)</td> + </tr> + <tr> + <td><code>Obsolete (verouderd)</code></td> + <td>verouderde functies (die niet meer in moderne browsers worden ondersteund)</td> + </tr> + <tr> + <td>others (andere)</td> + <td>Zie <a href="/nl/docs/Project:MDN/Contributing/Tagging_standards">MDN-labelstandaarden</a> voor andere mogelijke labels die kunnen worden toegepast</td> + </tr> + </tbody> + </table> + </li> + <li>Sla het artikel op met een opmerking.</li> + <li>U bent klaar!</li> + </ol> + </dd> +</dl> + +<p> </p> |