updated documentation for valid keys