Como faço para comentar um bloco de linhas em YAML?
YAML suporta comentários em linha, mas não suporta comentários em bloco.
Da Wikipedia:
Comentários começam com o sinal de número (
#
), podem começar em qualquer lugar em uma linha, e continuar até o final da linha
Uma comparação com o JSON, também da Wikipedia:
As diferenças de sintaxe são subtis e raramente surgem na prática: O JSON permite caracteres estendidos como UTF-32, o YAML requer um espaço após separadores como vírgula, iguais e dois pontos, enquanto o JSON não o faz, e algumas implementações não padronizadas do JSON estendem a gramática para incluir o Javascript
/* ... */
comentários. O tratamento desses casos de bordas pode exigir o pré-processamento leve do JSON antes de ser analisado como YAML em linha.
# If you want to write
# a block-commented Haiku
# you'll need three pound signs
O spec descreve apenas uma forma de marcação de comentários:
Um comentário explícito é marcado por um indicador "#".
É tudo. Não há comentários de bloco.
Não tentando ser inteligente, mas se você usar Texto Sublime para o seu editor, os passos são:
Imagino que outros editores também tenham uma funcionalidade semelhante. Qual deles você está usando? Terei todo o gosto em investigar.