readthedocs / readthedocs.org

The source code that powers readthedocs.org
https://readthedocs.org/
MIT License
7.98k stars 3.57k forks source link

Deprecations: list of all past and ongoing deprecations #10587

Open humitos opened 1 year ago

humitos commented 1 year ago

We have been deprecating pretty old non-used or broken features in the last weeks and we found ourselves a little lost about the big picture (whole plan) but also about what are the features that are going through the deprecation time. This issue just list them all here with the exact dates when they are making effective:

Feature Email (dates) Removal (dates) Affected projects
~https://github.com/readthedocs/readthedocs.org/pull/10514: Drop PyPy support~ Not sent July 18th 0
~https://github.com/readthedocs/readthedocs.org/pull/10550: Fail builds without index.html~ July 19th August 1st ~114
~https://github.com/readthedocs/readthedocs.org/pull/10508: Install latest version of requirements~ July 10th August 7th New projects
~https://github.com/readthedocs/readthedocs.org/pull/10494: Remove UPDATE_CONDA_STARTUP~ Jun 29th August 28th 13
~https://github.com/readthedocs/readthedocs.org/pull/10588: Remove DONT_SHALLOW_CLONE~ June 26th August 28th 61
~https://github.com/readthedocs/readthedocs.org/pull/5609: Doctools without config file~ July 11th August 28th 1.8k
~https://github.com/readthedocs/readthedocs.org/pull/10562: Remove python.system_packages~ August 7th August 29th ~8k
~https://github.com/readthedocs/readthedocs.org/pull/10367: No .readthedocs.yaml and v1~ Weekly (starting May 31th) September 25th All projects
~https://github.com/readthedocs/readthedocs.org/pull/10584: Drop support for MkDocs 0.17.3~ August 2nd October 3rd 293
~https://github.com/readthedocs/readthedocs.org/pull/10365: Drop support for Sphinx 1.x~ Aug 23th October 3rd ~8k
~https://github.com/readthedocs/readthedocs.org/pull/10589: Drop build.image~ Weekly October 16th ~16k
~https://github.com/readthedocs/readthedocs.org/pull/8840: Drop VCS (svn, hg, bzr)~ March 20th June 3rd ~6k
~https://github.com/readthedocs/readthedocs.org/pull/11206: Drop MKDOCS_THEME_RTD feature flag~ Undefined April 15th ~2
~https://github.com/readthedocs/readthedocs.org/pull/9993: Don't serve README.html at /~ May 28th July 1st ~250
https://github.com/readthedocs/readthedocs.org/pull/11441: Don't auto-inject Sphinx context/configs Soon July 29th & Oct 7th All Sphinx projects
https://github.com/readthedocs/readthedocs.org/pull/9530: Auto-injection of Google Analytics Undefined Oct 7th ~5k
https://github.com/readthedocs/readthedocs.org/issues/8659: Deprecate setup.py install Undefined Undefined ~350
https://github.com/readthedocs/readthedocs.org/issues/10677: Embed APIv2 removal Undefined Undefined ~30
https://github.com/readthedocs/readthedocs.org/issues/10637: Stop finding conf.py and mkdocs.yml Undefined Undefined ~950
https://github.com/readthedocs/readthedocs.org/issues/11037: Old incoming webhooks Undefined Undefined N/A

Related: https://github.com/readthedocs/readthedocs.org/issues/9779

Note: the table is sort by ascending "Removal (dates)"

ericholscher commented 1 year ago

This looks good. I might align the Sphinx 1.8 & Mkdocs .17 dates, since they seem like basically the same deprecation (eg. removing old default build tools).

stsewd commented 9 months ago

We are deprecating webhooks created without a secret on January 31st, 2024.

https://blog.readthedocs.com/security-update-on-incoming-webhooks/