Docs enhancement

When I started looking at the project I was very confused and the architecture document was not enough. For example what is the difference between qa/bin/qa and the gitlab-qa gem and why do we have 2 bin/qa ?