Adapted documentation according to developer comments
Merge pull request #1 from twalthr/BCVarsDocumentation

Adapted documentation according to developer comments