We're definitely very inconsistent about this in existing code... but since these are newly-added docs I agree, will fix.