doc updates
change "use_within" to "valid_for"