build: minor refactor
draft port of the smoke tests doc from the wiki.
Merge pull request #574 from epc/master

draft port of the smoke tests doc from the wiki.