Issue 17236: GET operation on baseURL/root.xml needs explicit MUST in the requirement (hdata-ftf) Source: MITRE (Mr. Jason Mathews, mathews(at)mitre.org) Nature: Clarification Severity: Minor Summary: The requirements reads as "This operation returns an XML representation of the current root document, as defined by the HRF specification." It can be inferred from this requirement that this is an implied “SHALL” or “MUST” mandatory requirement not an implied SHOULD/RECOMMENDED. Likewise, not defined if the baseURL does not exist, which should return 404 status code as done with similar HTTP operations. This would then be consistent with requirement in section 6.2. Revised requirement: This operation MUST return an XML representation of the current root document, as defined by the HRF specification. If there is no HDR at the base URL, the server SHOULD return a 404 - Not found status code. Resolution: Revised Text: Actions taken: March 13, 2012: received issue Discussion: End of Annotations:===== m: webmaster@omg.org To: Subject: Issue/Bug Report ******************************************************************************* Name: jason mathews Employer: MITRE mailFrom: mathews@mitre.org Terms_Agreement: I agree Specification: hData REST Binding for RLUS RFC Section: 6.3.1 FormalNumber: health/11-09-04 Version: 1.0 Doc_Year: 2011 Doc_Month: August Doc_Day: Day Page: 5 Title: GET operation on baseURL/root.xml needs explicit MUST in the requirement Nature: Clarification Severity: Minor CODE: 3TMw8 B1: Report Issue Description: The requirements reads as "This operation returns an XML representation of the current root document, as defined by the HRF specification." It can be inferred from this requirement that this is an implied .SHALL. or .MUST. mandatory requirement not an implied SHOULD/RECOMMENDED. Likewise, not defined if the baseURL does not exist, which should return 404 status code as done with similar HTTP operations. This would then be consistent with requirement in section 6.2. Revised requirement: This operation MUST return an XML representation of the current root document, as defined by the HRF specification. If there is no HDR at the base URL, the server SHOULD return a 404 - Not found status code.