Do we want to change the documentation to be more elaborate in the Hydra spec or is this acceptable brevity in the commentary?