Hi Damian,
On 4/21/21 2:32 PM, Damian Johnson wrote:
What is pywikibot's policy regarding code
deprecation? Can we remove
it after a set duration and, if so, what is it?
I'm not aware of Pywikibot having such a policy, but I think it would be
a good idea to have one. MediaWiki has a stable interface policy[1]
which defines what parts are stable to build on top of and which are
considered internal and then a process on how to deprecate and make
changes to what's supposed to be stable.
One of the things I worked on for MediaWiki's deprecation process is
developing codesearch[2] which makes it pretty straightforward for
developers to see what methods/functions are practically being used and
see what use cases are. I think something like that would be valuable
for Pywikibot as well, but code for most bots/scripts is really all over
the place. Something like Toolhub[3] would help with this too.
[1]
https://www.mediawiki.org/wiki/Stable_interface_policy
[2]
https://codesearch.wmcloud.org/search/
[3]
https://meta.wikimedia.org/wiki/Toolhub
HTH,
-- Legoktm