В этом репозитории размещен стандарт DOM.
Мы стремимся обеспечить дружелюбную, безопасную и гостеприимную среду для всех. Пожалуйста, прочтите и соблюдайте Кодекс поведения.
Люди постоянно замечают мелкие и более крупные проблемы со стандартом DOM, и мы будем рады вашей помощи в их исправлении. Запросы на включение типографских и грамматических ошибок также приветствуются.
Проблемы с пометкой «хороший первый выпуск» — хорошее место, чтобы попробовать редактировать стандарт DOM. Обратите внимание, что мы не назначаем проблемы, и нет причин запрашивать доступность, просто предоставьте запрос на включение.
Если вы подумываете предложить новую функцию, прочитайте FAQ и документы о рабочем режиме, чтобы ознакомиться с процессом.
Мы будем рады помочь вам со всем этим в чате.
Короче говоря, измените dom.bs и отправьте свой патч с хорошим сообщением о фиксации.
Пожалуйста, добавьте свое имя в раздел «Благодарности» в своем первом запросе на включение, даже если это касается тривиальных исправлений. Имена отсортированы лексикографически.
Чтобы убедиться, что ваш патч соответствует всем необходимым требованиям, ознакомьтесь также с Руководством для участников. Ожидается, что редакторы стандарта DOM будут следовать рекомендациям сопровождающего.
Тесты являются важной частью процесса стандартизации, и их необходимо будет создавать или корректировать по мере внесения изменений в стандарт. Тесты для стандарта DOM можно найти в каталоге dom/ файла web-platform-tests/wpt .
Панель мониторинга, показывающую тесты, выполняемые для браузерных движков, можно увидеть по адресу wpt.fyi/results/dom.
Для быстрой локальной итерации запустите make ; для создания стандарта будет использоваться веб-сервис, так что вам не придется ничего устанавливать. Дополнительную информацию см. в Руководстве для участников.
Используйте ширину столбца 100 символов.
Не используйте символы новой строки внутри «встроенных» элементов, даже если это означает превышение требований к ширине столбца.
< p > The
< dfn method for = DOMTokenList lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > …) </ code > </ dfn >
method, when invoked, must run these steps:все в порядке и
< p > The < dfn method for = DOMTokenList
lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > …) </ code > </ dfn > method, when
invoked, must run these steps:нет.
Использование новой строки между «встроенными» именами тегов элементов и их содержимым также запрещено. (Это фактически изменяет содержимое, добавляя пробелы.)
< a > token </ a >все в порядке и
< a > token
</ a >нет.
Внутри элемента <li> всегда есть элемент <p> , если только он не является дочерним элементом <ul class=brief> .
Если элемент «block» содержит один элемент «block», не помещайте его на новую строку.
Не делайте отступов ни для чего, кроме нового «блочного» элемента. Например
< li > < p > For each < var > token </ var > in < var > tokens </ var > , in given order, that is not in
< a > tokens </ a > , append < var > token </ var > to < a > tokens </ a > .не с отступом, а
< ol >
< li >
< p > For each < var > token </ var > in < var > tokens </ var > , run these substeps:
< ol >
< li > < p > If < var > token </ var > is the empty string, < a > throw </ a > a {{SyntaxError}} exception.является.
Могут быть включены закрывающие теги (если они выполняются последовательно), а атрибуты могут быть заключены в кавычки (с использованием двойных кавычек), хотя преобладающей темой является отсутствие закрывающих тегов, а не кавычек атрибутов (если они не содержат пробела).
Размещайте одну новую строку между абзацами (включая элементы списка). Поместите три новых строки перед <h2> и две новые строки перед другими заголовками. Это не применяется, когда вложенный заголовок следует за родительским заголовком.
< ul >
< li > < p > Do not place a newline above.
< li > < p > Place a newline above.
</ ul >
< p > Place a newline above.
< h3 > Place two newlines above. </ h3 >
< h4 > Placing one newline is OK here. </ h4 >
< h4 > Place two newlines above. </ h4 >Используйте верблюжий регистр для имен переменных и имена с интервалами для определений, алгоритмов и т. д.
< p > A < a for = / > request </ a > has an associated
< dfn export for = request id = concept-request-redirect-mode > redirect mode </ dfn > ,... < p > Let < var > redirectMode </ var > be < var > request </ var > 's < a for = request > redirect mode </ a > .
