docs changes and small fix