[wp-meta] [Making WordPress.org] #1: Add callout boxes to handbooks

[Making WordPress.org]

#1: Add callout boxes to handbooks
----------------------+-----------------------
  Reporter:  siobhan  |      Owner:
      Type:  task     |     Status:  new
  Priority:  low      |  Component:  Handbooks
Resolution:           |   Keywords:
----------------------+-----------------------

Comment (by siobhan):

 I'd like to keep it to four or five shortcodes, however the shortcode name
 should not be a colour, it should be what it's used for.

 The problem with using a colour is that then we need an additional
 reference to tell people what the shortcode is for, and it's too easy for
 people to think "hey, I just want a pretty colour so I'll use this box."

 Let's stick with
 [info] - additional information, more information, more advanced
 information
 [tip] - a tip that doesn't quite fit in with the body of the text but that
 is useful for people to know
 [warning] - a red box with stuff that should be avoided or definitely done
 [alert] - something that we need to alert the reader to - that the page is
 a draft or needs updated or whatever.

--
Ticket URL: <https://meta.trac.wordpress.org/ticket/1#comment:10>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org