Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
The continued list in section 6.6.3.1 was not being rendered as a list but as a continuation of the preceding paragraph. Adding the blank line makes it render as a list, but instead breaks the continued item numbering in MkDocs. Pandoc respects the starting number of the continued list, but MkDocs does not by default. This therefore requires the
sane_lists
MkDocs extension.Enabling the
sane_lists
extension could have unintended consequences, so I compared the "main" ARF page of the rendered MkDocs sites side by side to check. I found only one place affected apart from the intended one in 6.6.3.1, namely a nested bullet point list in section 6.6.3.9 which was being rendered as numbered items of the parent list. This list formatting was broken by enabling thesane_lists
extension, but fixed by indenting the nested lists to 4 spaces instead of 3.