update requirements/docs/settings
fix readme rst syntax