we could - but then the docs would be in a different place to the code and would be less likely to be updated.