Be more assertive with deprecation warning on APIv2
@@ -5,11 +5,14 @@ The Read the Docs API uses :abbr:`REST (Representational State Transfer)`.
JSON is returned by all API responses including errors
and HTTP response status codes are to designate success and failure.
-.. note::
+.. warning::
+
+ API v2 is planned to be deprecated soon, though we have not yet set a time
+ frame for deprecation yet. We will alert users with our plans when we do.
- API v2 will be soon completely deprecated. If you are integrating with Read
- the Docs, you should try to use :doc:`API v3 </api/v3>` instead. API v2 is
- still used by some application operations still.
+ For now, API v2 is still used by some legacy application operations still,
+ but we highly recommend Read the Docs users use :doc:`API v3 </api/v3>`
+ instead.
Some improvements in :doc:`API v3 </api/v3>` are:
