Details
-
Change Request
-
Resolution: Persuasive with Modification
-
Highest
-
US Core (FHIR)
-
4.0.0
-
Cross-Group Projects
-
STU
-
Home
-
1
-
-
Brett Marquard/Eric Haas: 15-0-0
-
Correction
-
Non-substantive
Description
The Home Page is technical note to balloters. That is the first impression anyone will have if they google for this spec. This is the first page everyone will read. It should be an advertisement for the project to executives, non-technical people, and technical people alike. It should include actual stories/scenarios that explain the overall purpose of the spec. Having that high level overview that explains the important problem this guide solves with relatable scenarios will draw people in. If someone looks at a document they expect it to start with a glossy executive summary that motivates them to read the rest of the document and if they do not have time to do that, motivates them to tell someone else to do it. This spec is helping to solve a really important problem and that is lost in the details. I realize that this seems to be a common shortcoming in the FHIR IGs but I think it is wrong. Also, recommend a high level sequence diagram that goes allow with a general scenario or with use cases either here or under use cases section. US Core is way too technical in general. The Note to Balloters should instead be its own Tab or after the summary.
Attachments
Issue Links
- is voted on by
-
BALLOT-28136 Negative - Virginia Lorenzi : 2022-Jan-FHIR US CORE R4.1 STU
- Closed