protect variables
mostly docstrings