Jan 2015 Ballot Comment #95

XMLWordPrintableJSON

    • Type: Change Request
    • Resolution: Persuasive with Modification
    • Priority: Medium
    • FHIR Core (FHIR)
    • DSTU1 [deprecated]
    • FHIR Infrastructure
    • (NA)
    • General
    • Hide

      Proposal - add toc link from the bottom of every page - "Specification Map". svn revision

      2015/03/19 MnM/FHIR Block Vote: Austin/Gordy 5-0-0

      Show
      Proposal - add toc link from the bottom of every page - "Specification Map". svn revision 2015/03/19 MnM/FHIR Block Vote: Austin/Gordy 5-0-0
    • Enhancement
    • Non-substantive
    • DSTU1 [deprecated]

      Comments
      The web-based format is OK for random navigation to a specific topic, but it is weak for reviewing and balloting. It's very difficult to know how big the spec is, how much of it I've covered, and what I have not read yet. Unlike a typical document, there are no "pages" and not even a detailed table of contents where I could check sections off as I read them. As I read through the spec and jump from page to page, it's almost impossible to know when I've read all there is to read on a topic. I suggest that future FHIR ballots include a PDF of what is ballotable. If the spec is concise as it claims, then a PDF should not be too voluminous.

      Grahame's Comments
      hah. The PDF would be massive (all the supporting stuff) - and we don't even know how to produce it. But there is a linear table of contents - it's the first thing on the documentation page, and from the home page. For exactly this purpose. Don't know what to do to make it more obvious.

            Assignee:
            Unassigned
            Reporter:
            david_tao
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: