chris wrote:
 >  to be honest i find it a bit confusing...

It's a quick reference card to for authors who already know the syntax
but need reminders.  It's not meant as something to learn from.
That's what the "See <http://docutils.sf.net/rst.html>  for full info"
is for.  You'll find tutorial and user documentation there.

-- David Goodger