close #12 - base documentation for the Bash implementation