added some inline variable type hints / fixed some doc blocks