Recabamos en distintos sitios para regalarte la respuesta para tu duda, si tienes dudas puedes dejar tu comentario y te respondemos porque estamos para ayudarte.
Solución:
Como ya averiguaste, los tres guiones ---
se utilizan para señalar el comienzo de un documentoes decir:
-
Para señalar el inicio del documento después de las directivases decir,
%YAML
o%TAG
líneas de acuerdo con las especificaciones actuales. Por ejemplo:%YAML 1.2 %TAG !foo! !foo-types/ --- myKey: myValue
-
Para señalar el inicio del documento cuando haya múltiples documentos yaml en la misma secuenciapor ejemplo, un archivo yaml:
doc 1 --- doc 2
Si el documento 2 tiene algunas directivas anteriores, entonces tenemos que usar tres puntos
...
para indicar el final del documento 1 (y el comienzo de las directivas potenciales que preceden al documento 2) al analizador. Por ejemplo:doc 1 ... %TAG !bar! !bar-types/ --- doc 2
La especificación es buena para los implementadores de analizadores yaml. Sin embargo, encuentro este artículo más fácil de leer desde la perspectiva del usuario.
No es obligatorio tenerlos si no comienzas tu YAML
con una directiva. Si es el caso, deberías usarlos.
Echemos un vistazo a la documentación.
3.2.3.4. Directivas
Cada documento puede estar asociado con un conjunto de directivas. Una directiva tiene un nombre y una secuencia opcional de parámetros. Las directivas son instrucciones para el procesador YAML y, como todos los demás detalles de presentación, no se reflejan en el árbol de serialización YAML ni en el gráfico de representación.. Esta versión de YAML define dos directivas, “YAML” y “TAG”. Todas las demás directivas están reservadas para futuras versiones de YAML.
Un ejemplo de esto también se puede encontrar en la documentación para directiva YAML
%YAML 1.2 # Attempt parsing
# with a warning
---
"foo"
Agradecemos que quieras añadir valor a nuestro contenido asistiendo con tu veteranía en los informes.