workflows: documentation enrichment

* Enriches the documentation of the Workflows module by adding
  more information on actions and the Holding Pen.

Signed-off-by: Jan Aage Lavik <jan.age.lavik@cern.ch>