[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 samuelsidler):

 Let's do this:

 || Shortcode || Describe || icon ||
 || [blue] || Information, links to external resources, tips and hints,
 etc. || dashicons-info ||
 || [yellow] || Can be used to note a draft page or any sort of behavior
 they need to watch out for. || dashicons-admin-post ||
 || [red] || Alerts the reader to a potential issue or problem. Something
 to be avoided. || dashicons-dismiss ||
 || [green] || Can be used to tell reader "what's next" or show good
 behavior. || dashicons-lightbulb ||

 Let's start with those. We'll use the design from @jerrysarcastic above.

 The key to the above working well is that we need to allow the icon to be
 changed in the short code to any available dash icon. That way, we don't
 prescribe too much meaning to each short code, but do give each a default
 meaning. Each handbook may have different uses for each short code, which
 we can document in the make/docs style guide.

 Note that this knocks us down to only four. I'd be fine with adding a
 fifth (grey/gray) that uses dashicons-admin-comments as its icon. But I
 think four is probably enough for now.

 What say you?

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