You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
yamllint/docs
Adrien Vergé ebd6b90d3e anchors: Add new rule to detect undeclared or duplicated anchors
According to the YAML specification [^1]:

- > It is an error for an alias node to use an anchor that does not
  > previously occur in the document.

  The `forbid-undeclared-aliases` option checks that aliases do have a
  matching anchor declared previously in the document. Since this is
  required by the YAML spec, this option is enabled by default.

- > The alias refers to the most recent preceding node having the same
  > anchor.

  This means that having a same anchor repeated in a document is
  allowed. However users could want to avoid this, so the new option
  `forbid-duplicated-anchors` allows that. It's disabled by default.

- > It is not an error to specify an anchor that is not used by any
  > alias node.

  This means that it's OK to declare anchors but don't have any alias
  referencing them. However users could want to avoid this, so a new
  option (e.g. `forbid-unused-anchors`) could be implemented in the
  future. See https://github.com/adrienverge/yamllint/pull/537.

Fixes #395
Closes #420

[^1]: https://yaml.org/spec/1.2.2/#71-alias-nodes
2 years ago
..
Makefile Doc: Generate documentation with Sphinx 9 years ago
conf.py Remove Unicode marker before strings 2 years ago
configuration.rst cli: Add --list-files command line option 2 years ago
development.rst docs: Fix misleading Python API example 2 years ago
disable_with_comments.rst docs: Explicitly specify language even when it's plain text 2 years ago
index.rst Add documentation for pre-commit 8 years ago
integration.rst docs: Update pre-commit hook example 2 years ago
quickstart.rst add OpenBSD installation instructions. 6 years ago
rules.rst anchors: Add new rule to detect undeclared or duplicated anchors 2 years ago
screenshot.png docs: Better compress PNG image 2 years ago
text_editors.rst docs: Update ALE vim plugin link 2 years ago