Jump to content

Template talk:BSLjunc: Difference between revisions

no edit summary
No edit summary
No edit summary
Line 1: Line 1:
The template is in itself not a bad idea, although the relative placement of the name/type/value and the respective fonts/colors can perhaps be improved for clarity (if it's all black and has the same typesetting, then the eye doesn't easily jump to the right information, even if for someone who knows what they're looking at).
The template is in itself not a bad idea, although the relative placement of the name/type/value and the respective fonts/colors can perhaps be improved for clarity (if it's all black and has the same typesetting, then the eye doesn't easily jump to the right information, even if for someone who actually looks at these boxes rather than at the surrounding text, and knows what they're all about).


A bigger issue is the space that it takes up. The one-line display such as <code>chr_dontaim [ai_name:string | script_id:int] on_off:int{0 | 1}</code> may not be appealing to Generation 2.0, but it fits on one line and does not break the flow of a page that supposedly contains some non-trivial scripting wisdom. Therefore, like in a coding textbook, an effort must be made to make those insets unobtrusive, less in-your-face if you will. A good (counter)example is [[BSL:AI_activity]] as it appears currently. Each section has some text about the meaning and effect of a group of commands, but before the text there's a list of the commands about to be described, and that "list" takes the form of an ill-shaped group of boxes that are not hidden by default (can't be hidden at all, for that matter), take up more space than the explanatory text, and remain very distractive while reading the text.
A bigger issue is the space that it takes up. The one-line display such as <code>chr_dontaim [ai_name:string | script_id:int] on_off:int{0 | 1}</code> may not be appealing to Generation 2.0, but it fits on one line and does not break the flow of a page that supposedly contains some non-trivial scripting wisdom. Therefore, like in a coding textbook, an effort must be made to make those insets unobtrusive, less in-your-face if you will. A good (counter)example is [[BSL:AI_activity]] as it appears currently. Each section has some text about the meaning and effect of a group of commands, but before the text there's a list of the commands about to be described, and that "list" takes the form of an ill-shaped group of boxes that are not hidden by default (can't be hidden at all, for that matter), take up more space than the explanatory text, and remain very distractive while reading the text.