Clarify and complete documentation

[danascape]

• This repo is a documentation part of https://github.com/sworkflow-project/sworkflow, so we want to document as much things as possible that comes in your mind, I am not too fond, but this is a requirement for the community