why not stick docblock next to function signature ?