Add docs and examples for sea ice production tasks

[darincomeau]

Adding documentation and examples to #907

[darincomeau]

@xylar I'm not sure how to get the docs to generate off a branch, so I haven't been able to verify/review the output here.

[xylar]

Thanks for the PR, @darincomeau!

I'm not sure how to get the docs to generate off a branch, so I haven't been able to verify/review the output here.

If you go into docs with your mpas_dev environment and run:

make html

then you should be able to build the docs on your laptop (or an HPC machine). Then, open:

_build/html/index.html

in a browser to see the results. If any red text comes up, we'd want to try to fix it. Some of it may already be fixed in #919, though.

[xylar]

You could rebase if you want, since I just merged #919. Then, hopefully you'll see a clean build.

[darincomeau]

Here's the documentation built from this branch on LCRC, so the LCRC header kinda gets in the way, but the new tasks show up:

https://web.lcrc.anl.gov/public/e3sm/diagnostic_output/ac.dcomeau/add-seaice-production-docs/html/

But during the build, I get a huge number of red WARNING: document isn't included in any toctree that seems unrelated? E.g.

...docs/generated/mpas_analysis.shared.timekeeping.utility.date_to_days.rst: WARNING: document isn't included in any toctree

[xylar]

Perfect! I don't know what the deal is with those "document isn't included" warnings but, no, don't worry about those. This looks great!

[xylar]

Just 4 really pedantic changes that sphinx tends to complain about.

[xylar]

@darincomeau, I went ahead and took care of it. It's too minor to bother you with. Thanks again!

[darincomeau]

ok great - thanks!