Documentation on disablePermalink not clear to me

[detj]

The language in this paragraph is not clear to me. I'm quoting verbatim.

Some template syntaxes are nicer than others and you may want to opt-out of the templating engine here. Use the dynamicPermalink option in your front matter to disable this on a per-template basis.

• Some template syntaxes are nicer than others - I find this a very subjective statement. Would be better if it could be rephrased with less ambiguity.
• I understand that the disablePermalink frontmatter option is to disable templating inside permalinks. But It is not clear to me what is the problem with the pug templating language specifically? Does the author mean to say, that pug lang doesn't support some templating feature that other templating languages support? Would be great if the documentation used an illustrative example.
• I don't understand what issue is being solved by disabling templating in permalink. Why is it a common pitfall? Can you elaborate as an answer?