add deprecation notice and link to current documentation

To be merged when the v1 documentation is published.