workflow and recommendations

Just added some documentation.
Mostly excercising.