LAMA to Dask: TODO tag cataloguing & further tidy

[sadielbartholomew]

Tidies the lama-to-dask branch further in the following ways:

• cataloguing the TODODASK markers left over from development work towards Replace LAMA with Dask to parallelise cf.Data #182 to aid with LAMA to Dask: address TODODASK items #433, because some are related and also some trivial, so it is very useful going forward to group and distinguish these (without stopping TODODASK overall from being searchable), notably to use:
  • TODODASKVER for cases of placeholders for the final version for the release with the Dask migration which can now be sorted easily in a targeted way via a single sed or similar command;
  • TODODASKDOCS for required docstring or documentation updates;
  • TODODASKMSG for use-facing messages e.g. error messages;
  • TODODASKAPI for API changes or considerations (potentially to bump to the release after Dask as per recent versioning discussions);
  • TODODASKDEPR for anything deprecation related;
  • anything else presently left as-is with TODODASK (miscellaneous etc.), these probably being the most meatly/difficult TODOs of all.
• converting any usage of np.ma.masked to cf.masked in the current docstring examples for consistency;
• address a TODO not related to the Dask migration;
• fix a typo.

See individual commits for separate work on each of the above.

[davidhassell]

Thanks, Sadie. This'll make things easier, and good spot on the Exception -> ValueError item.

[sadielbartholomew]

Thanks for reviewing David. I am about to push a few more 'TODO' tag identifier updates (sorry I should have mentioned that it might be best to review at the end, keeping this in draft form) but they are all quite trivial as with the rest of this PR, so if you don't think it necessary there's no need to review the few extra commits I'll push in a moment.

[davidhassell]

Ah - sorry for being slightly precipitous. Good idea to merge whenever you're ready.

[sadielbartholomew]

Ah - sorry for being slightly precipitous.

My fault in fact, sorry, I opened this in non-draft form by mistake so you were notified pre-maturely. Should have commented as such.

Good idea to merge whenever you're ready.

Thanks, will do.

[sadielbartholomew]

These methods marked TODODASKAPI are API-related and therefore can probably be bumped to be considered instead as part of work to do after the Dask migration release, i.e. tranform to plain TODOs that we can keep track of via a dedicated Issue. I'll note that on the main Issue #433.