2016-09-04 15:54 GMT+03:00 Merlijn van Deen (valhallasw) <valhallasw@arctus.nl>:
> Hi Strainu,
>
>> Are there any guidelines on the separation between the pywikibot
>> framework and the scripts bundled with it? I'm referring in particular
>> with the way things are deprecated/removed from the framework just
>> because they're not used _in the scripts bundled with pywikibot_.
>
>

Hi,

> The general guideline is that
>  - functions in scripts are considered 'private use', and can be
> removed/refactored without notice,
>  - functions in the framework are first deprecated, and removed at some
> later time.
>  - unless something is marked as internal (_ prefix) or something is
> practically internal (e.g. a helper function in pywikibot.data.api).

This makes sense.

>
> At the same time, master is a development branch, so this is not set in
> stone (otherwise large scale refactoring becomes impossible). We have a
> stable branch (2.0), which is what you should use if dealing with the
> occasional breakage is a large problem.

I don't really see how respecting the rules above in master would
prevent large scale refactoring. It would make it more complicated,
yes, but not impossible. Do you really feel this would make
development so much harder?

Strainu

_______________________________________________
pywikibot mailing list
pywikibot@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/pywikibot