Skip to content

Conversation

@colleenmcginnis
Copy link
Contributor

Related to #58 70070e9

Custom anchor links in headings can also contain underscores and uppercase letters:

  • Underscores are particularly common because by default AsciiDoc uses underscores in autogenerated IDs and those were carried over during the migration. We didn't attempt to standardize without underscores because it was not worth the effort to also update all links.
  • Though we probably want to discourage uppercase letters in custom anchor links, I don't think it's intuitive to prompt users to use sentence case in order to avoid uppercase letters in custom anchor links. If we feel strongly about not using uppercase letters, we should probably create a separate rule so we can use a more intuitive error message.

@colleenmcginnis colleenmcginnis self-assigned this Dec 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants