[documentation] Tip boxes (and other formatting ideas for handbooks)?

Michelle Cox mcox at charter.net
Thu Oct 5 18:04:58 UTC 2006


On 10/5/2006 11:17:05 AM, Laura Scott (laura at pingv.com) wrote:
> I submit two possible implementations for consideration:
>
>
> 1/ A highlight box, yellow (gradient?) background, for interesting or 
> notable content to highlight.
> 2/ An important note box, light-red background or perhaps red text, red 
> borders, for essential important info, such as "Note: This widget will not 
> work with foo, only with bar. Be sure to confirm your server settings 
> before implementiimplementing this widget!"

>Both types could be set at fixed width of, say, 200px and
>float:right. This would take some CSS editing, and would have to work
>with whatever d.o theme we might have for 5.0. What think you all?

I like this idea. I find docs much easier to understand when they aren't 
just all solid blocks of text.

What do you mean by "whatever d.o theme we might have for 5.0"? I haven't 
heard anything about them getting rid of Bluebeach. Did I miss something?

Michelle


More information about the documentation mailing list