update and reformat documentation

[katsikora]

• [ ] update outputs, DAGs and folder descriptions for workflows
• [ ] section on common options?
• [ ] add a cookbook/FAQ section
• [ ] update example datasets and code if necessary
• [ ] add a visitor counter
• [ ] make a twittorial