The Available variables lists, like the one at http://drupal.org/node/11816 , are difficult to scan visually. The variable names are interspersed with wrapped multi-line definitions and are not set out with formatting.

I'd suggest converting the bulleted lists to definition lists and styling the variable names in bold.

I'm attaching replacement markup for the list in http://drupal.org/node/11816 , additional CSS, and an HTML file that should demonstrate the finished presentation I'm suggesting.

CommentFileSizeAuthor
#2 11816.snip.txt974 bytespnm
#1 style_0.css97 bytespnm
11816.html40.18 KBpnm

Comments

pnm’s picture

pnm commented
StatusFileSize
new style_0.css97 bytes

Additional CSS.

pnm’s picture

pnm commented
Status: Active » Needs review
StatusFileSize
new 11816.snip.txt974 bytes

Snip for http://drupal.org/node/11816 body

webchick’s picture

webchick
she/they
Primary language English
Location Vancouver 🇨🇦
commented
Status: Needs review » Fixed

+ freaking 1!! This is one of those head-slapper, "totally obvious once someone points it out to you" things. Not only is it more legible, it's also more semantically correct.

I updated the ULs to DLs on block, box, comment, node, and page .tpl.php pages. The CSS changes I'm going to have to run past Steven; I could include them in the page, but I'd have to update the input format to "Full HTML" and then no one but site admins could edit...

webchick’s picture

webchick
she/they
Primary language English
Location Vancouver 🇨🇦
commented

Posted follow-up issue for the CSS changes to the Drupal.org infrastructure list: http://drupal.org/node/110728

Anonymous’s picture

(not verified) commented
Status: Fixed » Closed (fixed)