add links to new docs; more clear note?

This content is deprecated!