Стандартные метки статей в MDN

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Метки статей (теги для статей) — важный способ помочь пользователям находить нужный им контент.  Для упорядочения содержимого желательно, чтобы у каждой страницы было несколько меток. Эта статья расскажет, как лучше использовать метки, чтобы читатели могли найти информацию, и чтобы она была организованной.

Об использовании пользовательского интерфейса для редактирования меток на страницах см. в tagging section руководства для авторов статей.

Пожалуйста, используйте метки как следует, иначе наши программы не смогут правильно создавать или предлагать списки контента, главные страницы и связанные статьи.

Для чего в MDN используются метки

Метки используются в MDN для целого ряда целей:

Категоризация
Какого типа этот документ? Справка? Учебник? Целевая страница? С помощью этих меток наши посетители смогут фильтровать результаты поиска, так что они очень важны!
Идентификация темы статьи
Какой теме посвящена данная статья? Она — об API? О DOM? О графике? Эти метки тоже очень важны, так как и они используются для фильтрации результатов.
Статус технологии
Какой статус у данной технологии? Является ли она нестандартной? Устаревшей? Экспериментальной?
Уровень подготовки читателя
На какой уровень технической подготовки читателя рассчитан данный учебник или руководство?
Метаданные
Сообщество авторов документации использует метки, чтобы знать, какие статьи в какой работе нуждаются.

Руководство по типам меток

Здесь приводится сокращённое руководство по типам меток и их возможным значениям.

Категория

Снабжение статей метками этого типа способствует автоматической генерации главных страниц, оглавлений и т. п. Наша новая поисковая система тоже использует их, позволяя пользователям быстро находить интересующую их информацию.

Следующие категории являются стандартными метками, используемыми в MDN:

(Введение)
Статья содержит вводный материал по теме.  В идеале, к каждой технической области (technology area) должно быть только одно «Intro».
(Избранная)
Это одна из наиважнейших статей, ссылки на неё автоматически появятся на главных страницах.  Используйте эту метку пореже (никогда не более трёх документов в каждой области).
(Справка)
Данная статья содержит справочный материал по какому-либо API, элементу, аттрибуту, свойству и т. п.
(Главная)
Данная страница является главной по данной теме (landing page).
(Руководство)
Данная статья является руководством либо how-to.
(Пример)
Это страница примеров кода, или содержит примеры кода (фрагменты полезного кода, а не однострочные «примеры синтаксиса»).

Tема

Указание темы статьи способствует генерации лучших поисковых результатов, главных страниц и др. инструментов навигации.

Несмотря на известную гибкость рамок понятия «тема», мы стараемся придерживаться названий API или конкретных технологий. Несколько примеров меток:

Хорошая метка — идентификатор темы — название интерфейса, имеющего целый ряд связанных с ним страниц, (например, Node, которому посвящено много страниц документации с описанием его всевозможных свойств и методов), либо название всего ряда технологий. Страница о технологии WebGL может иметь метки Graphics и WebGL, например, а страница по элементу <canvas>HTML, Element, Canvas и Graphics.

Статус технологии

Метки этого типа призваны помочь читателю быстро сориентироваться в текущем статусе рассматриваемой технологии. Конечно же, в одной короткой метке невозможно отразить всё актуальное состояние какой-либо технологии и весь процесс её развития (для этого и служат таблицы спецификаций), но такая метка может помочь читателю с первого взгляда понять, стоит ли использовать описываемую в данной статье технологию в новом проекте.

Возможные значения этих меток:

(Нестандартная)
Указывает, что технология или API, описываемая на данной странице, не является частью стандарта, но считается стабильной в броузере или броузерах, поддерживающих её реализацию. Если Вы не используете эту метку, читатель ошибочно решит, что речь идёт о чём-то стандартизированном. Таблица совместимости на странице должна пояснять, какие конкретно броузеры поддерживают данную технологию или API.
(Устаревшая)
Технология или API, описываемая на данной странице, в спецификации помечена как устаревшая и, возможно, вскоре будет удалена, хотя пока ещё доступна в текущих версиях броузеров.
(Рудиментарная)
Технология или API считается рудиментарной и удалена (либо находится в процессе удаления) из большинства современных броузеров.
(Экспериментальная)
Технология в настоящее время не стандартизована и является экспериментальной, в будущем может стать или не стать частью стандарта.  Её существующая реализацая (обычно единственная) может измениться.
(Привилегированный доступ)
API требует привилегированного доступа к устройству, на котором выполняется код.
(Сертифицированный код)
API работает исключительно с сертифицированным кодом.

Эти метки — не повод не включить в статью таблицу совместимости!

Уровень подготовки читателя

Метка этого типа используется только для учебников и руководств (т.е., для страниц с меткой Guide). Она предназначена помочь читателю выбрать руководство, подходящее им по уровню знаний о данной технологии.  Возможны три значения данной метки:

(Начинающий)
Цель статьи — ознакомить читателя с технологией, которую он никогда прежде не использовал или знает лишь поверхностно.
(Средний)
Статья предназначена для читателей, свободно ориентирующихся в данной технологии, но не являющихся в ней экспертами.
(Продвинутый)
Статья вскрывает экстремальные горизонты как технологии, так и мозга читателя.

Метаданные страницы

Сообщество авторов статей указывает метками, что требуется сделать со страницей. Вот наиболее используемые у нас метки:

(мусор)
Статью надо удалить.
Статья — заготовка, или в ней как-то ещё недостаёт информации. Надо, чтобы кто-нибудь просмотрел статью и дополнил или дописал её.
Для статьи нужно сделать один или несколько примеров, иллюстрирующих то, что в ней написано. Для примеров лучше использовать систему действующих образцов.
В статье есть примеры, которые надо переоформить под систему действующих образцов.
Содержимое устарело и нуждается в обновлении.
Содержимое не сто́ит перевода и не будет появляться в статистике локализации.
Содержимое важно и имеет наивысший приоритет для переводчиков MDN. В статистике локализации выделяется в отдельную таблицу самого важного.

Карта веб грамотности

WebMaker проект, который через карту веб грамотности, определил навыки, необходимые для оптимального чтения, записи и использования  в Интернета. Мы используем навыки веб-грамотности, как метки на MDN, чтобы помочь пользователям найти ресурсы, которые наилучшим образом соответствуют их потребностям:

(Навигация)
В статье содержится информация о том, как ходить по веб-страницам
Информация о том, как устроена Всемирная паутина и как она работает
(Поиск)
Статья объясняет, как находить в Вебе информацию, людей и ресурсы
Информация в статье поможет читателю понять, как критически оценивать информацию, находимую в Вебе
(безопасность)
В статье приводится информация о том, как сохранить системы, идентичностей, и содержимое сейфа.
В документе объясняется, как создать и курировать контент для интернета.
Статья учит, как модифицировать существующие веб-ресурсы, чтобы создавать что-то новое.
Документация, разъясняющая, как повысить уровень визуальной эстетики и пользовательский опыт.
Документы, в которых описывается, как общаться в универсально-узнаваемом образе.
Как написать код и/или для создания интерактивных проектов в Интернете.
Документ объясняет, как работает техническая укладка Интернета.
Содержание статьи охватывает способы создания ресурсов с другими.
В документе содержится информация о том, как работать с другими людьми.
 
В статье подробно описано, как вступать в сетевые сообщества и понять, как они работают.
Материал помогает рассмотреть последствия предоставления данных онлайн..
В статье говоритя о том, как помочь сохранить Web общедоступными

Собираем воедино

Итак, каждой странице можно присвоить метки сразу из нескольких типов. Например:

Учебник по WebGL для начинающих
WebGL, Graphics, Guide, Beginner
Справочная страница по элементу <canvas>
Canvas, HTML, Element, Graphics, Reference
Главная страница по средствам разработки Firefox OS
Tools, Firefox OS, Landing

Темы и поисковые фильтры

Для фильтрования результатов поиска необходимо, чтобы страницы MDN были правильно помечены. Вот таблица поисковых фильтров и соответствующих меток.

Примечание: Если в колонке «Метки» указано несколько меток, это значит, что фильтр найдёт статью с любой из этих меток.

Группа фильтров Название поискового фильтра Метки
Темы Open Web Apps
  HTML
  CSS
  JavaScript
  API и DOM
  Canvas
  SVG
  MathML
  WebGL
  XUL
  Marketplace
  Firefox
  Firefox для Android
  Firefox для настольных компьютеров
  Firefox OS
  Mobile
  Веб-разработка
  Дополнения и расширения || || ||
  Игры
Уровень Я — эксперт
  Средний
  Я новичок
Тип документа Docs This restricts the search to docs content, leaving out Hacks and other MDN content.
  Demos This includes Demo Studio content in the search results.
  Инструменты
  Примеры кода
  Уроки
  Developer Profiles This includes developer profiles from the MDN site in the search results.
  External Resources The dev team is still figuring this out...

Проблемы с метками, которые вы можете починить

Существует несколько видов проблем с тегами,и Вы можете помочь их решить:

Нет меток
Как правило, статьи должны иметь по крайней мере тег "Категория" и тег"тема". Обычно другие теги соответствующие, но если Вы можете помочь нам обеспечить минимальное присутствие тегов , Вы будете герой документации !
Метки не соответствуют нашим стандартам меток
Просим исправлять любые документы, чьи метки не соответствуют описанным здесь стандартам.
Примечание: из-за бага в Kuma, на некоторых английских страницах появлялись переведённые метки (такие как Référence). Они обычно появляются снова даже после удаления, поэтому не возитесь с их исправлением, пока не исправят баг в Kuma.
Неправильные метки
Если вы смотрите на статью о HTML и она  помечена как  "JavaScript", это, вероятно, неправильно! Точно так же, если статья обсуждает Mozilla, но имеет тег «Web», это, вероятно, неправильно тоже. Удалить эти теги и добавить нужные теги, если они уже не существуют. Просьба также исправить метки с ошибками (например, "Javascript" будет по-прежнему соответствовать, поскольку метки не чувствительны к регистру, но давайте не будем неаккуратными!).
Недостающие метки
If an article has some but not all of the tags it needs, feel free to add more. For example, if a page in JavaScript reference is (correctly) tagged "JavaScript" but nothing else, you're invited to tag the page "Reference" as well!
Спам в метках
Эта коварщина — самая отвратительная проблема: some Web vermin has deposited its droppings in the page tags (типа «Free warez!» или «Hi, я ходил по вашему сайту и хотел спросить вас, не поможете ли вы мне решить мою проблему: у меня флэш постоянно падает»). Такие «метки» надо удалять сразу же! Они неприятны, с ними трудно справиться, если позволить им накопиться, и они ужасно вредны с точки зрения SEO.

If you see one (or more) of these problems, please log into MDN and click EDIT 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.

Метки документа и участники

 Внесли вклад в эту страницу: AleksKAN, bracket, Aleksej, Nick_Pershin
 Обновлялась последний раз: AleksKAN,