extended docstrings to state numbers functions