Due to #1301, the following manual pages will need to be updated:
doc/long_vignettes/tskitconvert_vignette.md
doc/long_vignettes/tskit_metadata_vignette.md
The "developer's guide" could also use a section on how to more effectively deprecate things.
Since jupyterbook is not reliable when it comes to "treat all warnings as errors", it is best to do something like add hard assertions at the point of deprecation, clean up the damage (docs/tests), and then replace the assertion with the deprecation warning.
Due to #1301, the following manual pages will need to be updated:
The "developer's guide" could also use a section on how to more effectively deprecate things. Since jupyterbook is not reliable when it comes to "treat all warnings as errors", it is best to do something like add hard assertions at the point of deprecation, clean up the damage (docs/tests), and then replace the assertion with the deprecation warning.