mbeliaev/docs depr

[beliaev-maksim]

here is look and feel

@markstory
do you think we need to add info about removed internals as well?

[codecov]

Codecov Report

Merging #517 (4ca2ce6) into master (1724937) will not change coverage.
The diff coverage is n/a.

@@            Coverage Diff            @@
##            master      #517   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files            6         6           
  Lines         2305      2305           
=========================================
  Hits          2305      2305           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 1724937...4ca2ce6. Read the comment docs.

[markstory]

do you think we need to add info about removed internals as well?

I don't think so. Users shouldn't have been using them and I don't think we should be on the hook for them using features that weren't meant to be used.