#1351 - Support for user-defined kernels that operate on DoFs

[oakleybrunt]

Towards #1351

This PR adds the documentation for DoF Kernels, part of a 3-step process of documentation, metadata checks, and code generation.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.86%. Comparing base (91119cd) to head (abd9101).

Additional details and impacted files

@@           Coverage Diff           @@
##           master    #2556   +/-   ##
=======================================
  Coverage   99.86%   99.86%           
=======================================
  Files         357      357           
  Lines       48339    48339           
=======================================
  Hits        48273    48273           
  Misses         66       66           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[arporter]

Thanks for this Oakley. I think you've mostly got the top-level rules sorted but you're missing a section on the rules for the kernel subroutine itself - see inline. Note I've brought the branch up to master so you'll need to pull before you make changes.

[oakleybrunt]

Thanks for this Oakley. I think you've mostly got the top-level rules sorted but you're missing a section on the rules for the kernel subroutine itself - see inline. Note I've brought the branch up to master so you'll need to pull before you make changes.

Hey Andy, thanks for your comments. I completely overlooked this, ha! You're right, the subroutine rules will be quite simple. I've added them now so I'll re-request a review.

[arporter]

Thanks Oakley. Looking pretty good now. I've realised we're missing the rather crucial OPERATES_ON for this kernel type and I found another bit of the docs that need updating.
We also need to be clear that support for this new kernel type is not yet implemented (a slight disadvantage of doing things this way but the overhead shouldn't be too bad).

When this is "ready for review" again, please could you add the appropriate label to the PR - that makes it easy for me to see in the list of PRs.

[arporter]

Thanks for making those changes. I've taken the liberty of fixing a couple of typos and this is now ready to go once the CI has passed.