Add an explicit example deprecating a class

Add an explicit example deprecating a class #1720