bb gh merge



Pull request for [bb gh merge](https://trello.com/c/pkU0gunr/1807-bb-gh-merge).

    
:+1: I actually like such docs also as a reviewer, it helps me to understand the intent better and check if the code does what it should - please continue with this also in future