Replies: 1 comment 1 reply
-
That looks like a good improvement! PRs are welcome. |
Beta Was this translation helpful? Give feedback.
1 reply
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
-
Maddy's configuration directive docs are incredibly useful, but are not easy to scan visually. The reader must find the right line that starts with "Syntax:", then read the section, without "overshooting" into the next section:
I'm proposing a few formatting changes to make each section easier to find visually:
I moved the "Syntax: " line to a
<h3>
element, and added<hr>
separators between sections. I removed bold from the "Default:" line to reduce visual clutter. I made a tiny CSS change in the alb theme to make<hr>
element thinner.Markdown source (fragment):
@foxcpp what are your thoughts on this? Yay or nay? I'd be happy to make a PR (or several smaller PRs) that reformat the docs.
Beta Was this translation helpful? Give feedback.
All reactions