updated vocabulary doc and model docstrings