Author here. I think it's a pretty nice idea to include deprecation information in the response headers as another way to keep API integrators informed - alongside written forms of communication like blog posts, changelog entries and emails. We'll discuss that internally.

As @xavdid noted, the reality is that most people won't see these headers, but it's a nice power user feature.