Description

Improve variable documentation

Closes #786 (closed) Closes #777 (closed)

Checklist

I have checked that my code follows the Octopus coding standards
I have added tests for all the new features added in this request.