Este repositorio aloja el estándar DOM.
Estamos comprometidos a brindar un ambiente amigable, seguro y acogedor para todos. Lea y respete el Código de conducta.
La gente nota problemas menores y mayores con el estándar DOM todo el tiempo y nos encantaría que nos ayudaran a solucionarlos. Las solicitudes de extracción de errores tipográficos y gramaticales también son bienvenidas.
Los números etiquetados como "buen primer número" son un buen lugar para probar la edición del estándar DOM. Tenga en cuenta que no asignamos problemas y tampoco hay motivo para solicitar disponibilidad, solo proporcione una solicitud de extracción.
Si está pensando en sugerir una nueva función, lea los documentos de Preguntas frecuentes y Modo de trabajo para familiarizarse con el proceso.
Estaremos encantados de ayudarte con todo esto en el Chat.
En resumen, cambie dom.bs
y envíe su parche, con un buen mensaje de confirmación.
Agregue su nombre a la sección Agradecimientos en su primera solicitud de extracción, incluso para correcciones triviales. Los nombres están ordenados lexicográficamente.
Para asegurarse de que su parche cumpla con todos los requisitos necesarios, consulte también las Pautas para colaboradores. Se espera que los editores del estándar DOM sigan las pautas del mantenedor.
Las pruebas son una parte esencial del proceso de estandarización y deberán crearse o ajustarse a medida que se realicen cambios en el estándar. Las pruebas para el estándar DOM se pueden encontrar en el directorio dom/
de web-platform-tests/wpt
.
Se puede ver un panel que muestra las pruebas que se ejecutan en los motores del navegador en wpt.fyi/results/dom.
Para una iteración local rápida, ejecute make
; esto utilizará un servicio web para crear el estándar, de modo que no tenga que instalar nada. Vea más en las Pautas para colaboradores.
Utilice un ancho de columna de 100 caracteres.
No utilice líneas nuevas dentro de elementos "en línea", incluso si eso significa exceder el requisito de ancho de columna.
< p > The
< dfn method for = DOMTokenList lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > …) </ code > </ dfn >
method, when invoked, must run these steps:
está bien y
< p > The < dfn method for = DOMTokenList
lt = remove(tokens)|remove() > < code > remove( < var > tokens </ var > …) </ code > </ dfn > method, when
invoked, must run these steps:
no lo es.
También está prohibido el uso de nuevas líneas entre los nombres de etiquetas de elementos "en línea" y su contenido. (Esto en realidad altera el contenido al agregar espacios).
< a > token </ a >
está bien y
< a > token
</ a >
no lo es.
Un elemento <li>
siempre tiene un elemento <p>
dentro, a menos que sea hijo de <ul class=brief>
.
Si un elemento "bloque" contiene un único elemento "bloque", no lo coloque en una nueva línea.
No aplique sangría a nada excepto a un nuevo elemento de "bloque". Por ejemplo
< 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 > .
no está sangrado, pero
< 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.
es.
Se pueden incluir etiquetas finales (si se hacen de manera consistente) y los atributos se pueden citar (usando comillas dobles), aunque el tema predominante es omitir etiquetas finales y no citar atributos (a menos que contengan un espacio).
Coloque una nueva línea entre los párrafos (incluidos los elementos de la lista). Coloque tres líneas nuevas antes de <h2>
y dos líneas nuevas antes de otros títulos. Esto no se aplica cuando un encabezado anidado sigue al encabezado principal.
< 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 >
Utilice camel-case para nombres de variables y nombres "espaciados" para definiciones, algoritmos, etc.
< 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 > .