Leitfaden zur sachgemäßen Seitenkennzeichnung

Artikel-Schlagwörter sind ein wichtiges Hilfsmittel Besuchern zu ermöglichen, hilfreichen Inhalt zu finden. Jede Seite sollte im Normalfall mehere Schlagwörter enthalten. Diese Seite zeigt den Lesern wie Tags funktionieren und wie man sie aufbewahren sollte.

Um Seiten zu finden, auf denen man erfährt, wie Schlagwörter editiert werden können, rufen Sie bitte den Link tagging section in unserem Editor-Handbuch auf.

Bitte beachten Sie, dass die korrekte Anwendung von Tags sehr wichtig ist.

Tun Sie es nicht, sind unsere automatischen Werkzeuge nicht in der Lage, Listen mit den gewünschten Seiten zu generieren.

Zunehmend arbeiten wir daran, automatisierte Listen zu erstellen, die auf den gewünschten Inhalt, erreichte Seiten und miteinder verlinkte Artikel aufführen. Um zu verhindern, dass Artikel mit unzutreffenden Tags versehen werden, lesen Sie bitte weiter.

Tag-Anwendung auf MDN

Es gibt verschiedene Möglichkeiten, Schlagwörter auf MDN anzuwenden:

Dokument-Kategorisierung: Um welchen Dokumenten-Typ handelt es sich? Ein Tutorial? Eine Referenz? Eine aufgerufene Seite? Diese Methoden können angewendet werden, wenn sie als Suchfilter dienlich sein sollen und sind deshalb sehr wichtig!
Topic-Identifizierung: Welches Topic deckt der Artikel ab? API? DOM? Grafik? Auch diese Identifizierungs-Merkmale können als Suchfilter angewendet werden und sind deshalb ebenfalls sehr wichtig.
Technologie-Status: Welcher Technologie-Status exisiert? Kein Sandard? Nicht mehr zur Anwenden kommend oder veraltet? Experiment?
Skill-Level: Für Tutorials und Anleitungen - wie weit fortgeschritten ist das Material im Artikel?
Dokument-Metadaten: Oft benötigt die publizierende Gemeinschaft eine Anleitung, welche Wege zu beschreiten sind, um die gewünschten Informationen/Seiten zu finden. Das wird mit Schlagwort-Anwendung realisiert.

Tag-Typ Handbuch

Anschließend finden Sie die verschiedenen Tag-Typen mit ihrem möglichen Wert.

Kategorie

Ein mit Schlagwörtern versehener Artikel mit Hilfe der Kategorien-Anwendung ist insofern hilfreich, erreichte Seiten und/oder eine Tabelle mit Inhalts-Seiten aufzurufen.

Die folgenden Begriffe werden auch in unserem neuen Such-System angewendet Vielleicht, um den Anwendern die Möglichkeit zur Verfügung zu stellen, die von ihnen gesuchten Informationen oder ein Handbuch ihrer Wahl zu finden.

MDN wendet die folgenden Bezeichnungen mit den Standard-Tags an.

Intro: Der Artikel stellt Einführungs-Material übei ein Topic zur Verfügung. Theoretisch sollte nur eines pro Technologie-Breich existieren.
Featured: Dieser Beitrag ist ein äußerst wichtiger Artikel, der mittels einer speziellen Methode auf erreichte Seiten hinweist Bitte achten Sie auf eine äußerst sparsame Anwendung. Es sollten max. drei oder weniger in den Dokumentations-Bereichen existieren.
Reference: Der Artikel enthält Referenz-Material über ein API, Element, Attribut, Merkmal o.ä.
Landing: Für eine aufgerufene Seite.
Guide: Der Artikel zeigt ob und wie man eine Seite benutzt.
Example: Diese Seite beschreibt Code-Auswahlen, oder beinhaltet Code-Proben. Sie sollte aber nicht für einzeilige "Syntax-Beispiele" angewendet werden, kann aber Bruchstücke sinnvoller Codes enthalten oder voll anwendbare Auswahlen.

Topic

Mit der Anwendung Topic im Bereich können Sie auch helfen, sowohl bessere Suchresultate zu erzeugen als auch erreichte Seiten und weitere Navigations-Hilfen zu finden.

Derweil exisitiert noch Platz, um die Flexibilität für neue Topic-Bereiche zu erreichen und wir versuchen diese in API's bzw. Technologien zu integrieren Einige hilreiche Bespiele:

HTML
CSS
JavaScript (notice the capital "S"!)
Document
DOM
API for each interface, method and property.
Method for each method of an API
Property for each property of an API
Graphics
Firefox OS
Gecko
XUL
XPCOM
SVG
WebGL
Element
Node
Tools
Web

Generell nützlich ist der Name eines Interfaces, welches auf eine Anzahl von zutreffenden Seitent hinweist, wie z.B. Node (mit vielen Links bez. verschiedener Eigenschaften und Methoden) und macht ein gutes Topic-Identifizierungs-Schlagwort wie es eine übergreifende Technologie oder auch der Technologie-Typ tut. Eine Seite über WebGL möglicherweise mit den Tags Graphics und WebGL versehen. Zum Bespiel über {HTMLElement("canvas")}} Element könnte tagged HTML, Element, Canvas, und Graphics.

Technologie-Status

Um dem Leser klar zu machen, wie praktikabel eine Technologie ist, wenden wir Tags an, Seiten zu kennzeichnen, um zu zeigen, in welchem Status sich die Spezifikationen der betreffenden Technologie befinden.

Hier wird weder eine detailierte Analyse noch eine Beschreibung abgegen was die Spezifikation ist und wo sich der Spezifikations-Prozess der Technologie befindet (dazu dient die Spezifikations-Tabelle). Jedoch stellt es in Kurzform eine Hilfe zur Anwender-Beurteilung zur Verfügung, ob die Benutzung der beschriebenen Technologie als gute Idee zu werten ist - oder auch nicht.

Anschließend finden Sie mögliche Werte für diese Tags:

Non-standard: Weist darauf hin, daß die auf der Seite beschriebene Technologie oder API nicht Teil des Standards ist, jedoch in Browsern, in denen Technologie und API implementiert sind, stabil funktioniert. Wenn Sie dieses Schlagwort nicht anwenden, liegt die Vermutung nahe, dass der Artikel Standards abdeckt. Die Verträglichkeits-Übersicht auf der Seite sollte klarstellen welche Browser diese Technologie bzw. API unterstützen.
Deprecated: Die Technologie oder die API auf der Seite wurden in der Spezifikation als veraltet gekennzeichnet und es ist zu erwarten, dass sie entfernt werden, jedoch in den derzeitigen Browsern noch verfügbar.
Obsolete: Die Technologie oder die API wurden als nicht mehr zeitgemäss eingestuft und deshalb entfernt bzw. es laüft gegenwärtig ein Prozess, um sie von allen bzw. den meisten aktuellen Browsern zu entfernen.
Experimental: Die Technologie/API ist kein Standard sondern in der Experimentier-Phase und wird wahrscheinlich nie Teil eines Standards sein.
Needs Privileges: Die API muß über den Status eines bevorzugten/privilegierten Zugriffs verfügen, um auf das Gerät zugreifen zu können, wo der Code läuft.
Certified Only: Die API funktioniert ausschliesslich im zertifizierten Code.

Bei der Anwendung dieser Tags sollten Sie sicherstellen, dass in Ihrem Beitrag eine Kompatibilitäts-Tabelle: compatibility table enthalten ist!

Kenntnis-Niveau

Das Kenntnis-Niveau-Schlagwort wird nur für Guides und Übungen angewendet (Seiten mit Tags gekennzeichnete Guides). Es hilft Benutzern beim Reduzieren von Übungen, die über einen Kenntnisstandon bez. einer ihnen Technologie auf vertrautem Level verfügen - beispielsweise die folgenden drei Kenntnis-Ebenen:

Beginner: Beiträge für Anfänger mit dem Zweck der Einführung in eine Technologie die sie noch nie angewendet haben bzw. nur wenig familiär mit ihr sind.
Intermediate: Artikel für Anwender, die zwar schon begonnen haben, die Technologie zu benutzen, jedoch keine Experten sind.
Advanced: Beiträge, die das Ziel verfolgen, die Fähigkeiten der Technologie-Anwendung zu erweitern.

Dokument-Metadaten

Die produzierende Gemeinschaft wendet Tags an, um Artikel zu kennzeichnen, für die eine spezifische Arbeitsweise erforderlich ist -> die am meisten

junk

Beitrag enthält wertloses Zeug - sollte entfernt werden.
NeedsContent: Der Artikel ist nutzlos bzw. ohne hilfreiche Informationen. Das bedeutet, dass jemand den Inhalt überarbeiten, mehr Details hinzufügen und/oder das Schreiben beenden sollte.
NeedsExample: Der Beitrag erfordert ein oder mehrere Beispiele, um seinen Zweck zu illustrieren. Solche Beispiele sollten live sample system benutzen.
NeedsLiveSamples: Ein oder mehrere Beispiele müssen upgedatet werden - zu finden unter live sample system.
NeedsUpdate: Der Inhalt ist veraltet und muss upgedatet werden.
l10n:exclude: Der Inhalt ist nicht korrekt lokalisiert und wird nicht auf Übersetzungs-Status-Seiten erscheinen.
l10n:priority: Der Inhalt ist wichtig und sollte für MDN-Übersetzer als priorisiert markiert sein. Aufgezeigt in einer Extra-Prioritäts-Tabelle auf Lokalisierungs-Status-Seiten.

Web Literacy Map

Das WebMaker Projekt, siehe Web Literacy Map, hat eine Reihe von Tags definiert, um die verschiedenen und empfohlenen Fähigkeiten zu definieren, die ein besseres Lesen, Schreiben und die Teilnahme am Web ermöglichen. Wir benutzen sie auf MDN, um unseren Anwendern die besten Resourcen zu finden, welche ihren Ansprüchen genügen:

Navigation: Der Beitrag liefert Informationen darüber wie man das Web durchsuchen kann.
WebMechanics: Der Beitrag liefert Informationen darüber wie das Web organisiert ist und wie es funktioniert.
Search: Der Beitrag zeigt die Möglichkeiten auf, wo Informationen, Personen und Resourcen mittels des des Webs zu finden sind.
Credibility: Der Artikel liefert Informationen darüber wie kritisch zu bewertende Informationen sind, die auf dem Web gefunden wurden.
Security: Der Artikel liefert Informationen wie man Systeme, Identitäten und Inhalt sicher aufbewahrt.
Composing: Der Artikel liefert Informationen wie Inhalt für das Web kreiert und sichert.
Remixing: Der Artikel liefert Informationen wie man existierende Web-Resourcen nutzt, um neue Inhalte zu erstellen.
DesignAccessibility: Der Artikel liefert Informationen darüber, wie eine effektive und universelle Kommunikation mittels Nutzung der Web-Resourcen zustande gebracht werden kann.
CodingScripting: Der Artikel liefert Informationen wie interaktive Kodierung und/oderErfahrungen auf dem Web erstellt werden können.
infrastructure: Der Artikel liefert Informationen, die das Verständnis der Internet-Technik aufzeigen.
Sharing: Der Artikel zeigt auf, wie man zusammen mit anderen Teilnehmern Resourcen kreiert.
Collaborating: Der Artikel liefert Informationen wie man mit an deren zusammenarbeiten kann.
Community: Der Artikel liefert Informationen wie man in Web-Communities eingebunden werden kann und zeigt deren Praktiken auf.
Privacy: Der Artikel liefert Informationen über Konsequenzen, wenn Daten online ausgetauscht werden.
OpenPracticies: Der Artikel liefert Informationen wie geholfen werden kann, das Web universell zugänglich zu machen.

Zusammenfassung

Mit diesen verschiedenen Tag-Typen verfügen Sie über eine Sammlung, die ein komplettes Set für eine Seite bietet. Ein paar Beispiele:

Anleitung für Anfäger WebGL betreffend: Geeignete Tags: WebGL, Graphics, Guide, Beginner
Referenz-Seite für das <canvas> Element: Tags für "Canvas-Element:Canvas, HTML, Element, Graphics Reference
Seite für Firefox OS Entwickler-Werkzeuge: Siehe folgende Tags:Tools, Firefox OS, Landing

Tagging und Such-Filter

Eine anstehende Suchfilter-Implementierung, die Benutzer in die Lage versetzt, die gewünschten Ergebnisse darauf zu begrenzen, dass sie den vorgegebenen Kriterien entspricht, wird auf MDN mittels korrekter Seite realisiert weren. Anschließend finden eine Übersicht mit den verschiedenen Such-Filtern und wonach Tags suchen.

Note: Falls multiple Tags unter "Tag Name" gelistet sind, bedeutet das, dass irgend ein oder mehrere benötigt werden, um dem Beitrag gerecht zu werden.

Filter group	Such-Filter Name	Tag name
Topic	Open Web Apps	Apps
	HTML	HTML
	CSS	CSS
	JavaScript	JavaScript
	APIs and DOM	API
	Canvas	Canvas
	SVG	SVG
	MathML	MathML
	WebGL	WebGL
	XUL	XUL
	Marketplace	Marketplace
	Firefox	Firefox
	Firefox for Android	Firefox Mobile
	Firefox for Desktop	Firefox Desktop
	Firefox OS	Firefox OS
	Mobile	Mobile
	Web Development	Web Development
	Add-ons & Extensions	Add-ons \|\| Extensions \|\| Plugins \|\| Themes
	Games	Games
Skill level	I'm an Expert	Advanced
	Intermediate	Intermediate
	I'm Learning	Beginner
Document type	Docs	This will restrict the search to docs content, leaving out Hacks and other MDN content.
	Demos	This will include Demo Studio content in the search results.
	Tools	Tools
	Code Samples	Example
	How-To & Tutorial	Guide
	Developer Profiles	This will include developer profiles from the MDN site in the search results.
	External Resources	This is something the dev team will need to figure out.

Tagging-Probleme, die Sie beheben können

Es existieren verschiene Tag-Typen-Probleme, die Sie reparieren können.

Alle Artikel sollten zumindest einen Tag enthalten - üblicherweise noch mehr. Grundsätzlich sollten die Tags category und topic verfügbar sein. Oftmals sind auch andere Tags zweckmäßig. Sie können uns jedoch helfen, sicherzustellen, daß wenigtens diese Tags vorhanden sind -> das macht Sie zu einem Dokumenten-Held!
Tags die nicht unseren Standards entsprechen: Wie offerieren eine Tagging standards Anleitung, die erklärt wie wir Tags anwenden. Eingeschlossen sind Listen mit gültigen Tags, welche bei diversen Dokumentations-Typen angewendet werden. Idealerweise sollten alle Beiträge diesen Standards folgen, so dass Sie eine Seite sehen können, die nicht den vorgegebenen Regeln entspricht -> BITTE reparieren!
Unkorrekte Tags: 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!).
Missing tags: 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!
Tag spam: 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!

If you see one (or more) of these problems, you can help by logging into MDN, 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 "The tags box" in the MDN editor guide.