added: @Raw

minor updates on documentation + corrected some code