docs for Perl and Bash flavors - wip