[ScottishTapWater]

Summary

• Document comparisons, numerical helpers, and nullable quantities.
• Describe expanded discovery support, including generic interfaces, patterns, awaited results, and iterators.
• Correct the outdated async/iterator limitation.

Verification

• Capability descriptions independently reviewed against source and tests.
• git diff --check passed.
• Documentation-only change; no runtime tests rerun.