fix typo
add section on deprecation policy, handle remarks w.r.t. consistency across sections