Add how-to-update section to doc and deprecation tests

• Extended how-to-update section by changes from !104 (merged)
• Add tests t make sure that DeprecationWarnings are raised properly