TOC Placement Issues Resulting in Innacurate TOCs
USER STORY
Sometimes the system does not know exactly where to place a chapter component in the book manager page. Coko without NCBI review tried to address this with a "TOC?" icon that is not fully understood by users. The user is also not forced to address this icon notification before a TOC is built and automatically published that has resulted during testing in inaccurate TOCs being built.
PROPOSED SOLUTIONS
-
Require ALL chapter-processed books to have an Admin / Editor required to approve chapter components before they are published -
Rename icon to a "Cannot Place in TOC" red query, and provide a tool tip saying "The BCMS does not know where to place this in the table of contents. Please address in your source Word file or manually drag the component to where it belongs." -
The "Cannot Place in TOC" query is communicated in an email notification to users. -
User is forced to click and resolve any "Cannot Place in TOC" red warning if / once they have resolved it via a manual action. -
No TOC.XML will be written and published if there are any "Cannot Place in TOC" queries.
RELATED DOCUMENTATION
From issue #24 (closed)
Manual grouping / sorting rules:
-
IF manual sorting order is selected by the user, user can drag their chapter exactly where they want it in the body of the TOC
- [ ] IF more than one front matter component, the BCMS places the component at the top of the Front unit and provides a notification (on the display page and by email?) that it is unable to place the document per supported automatic rules AND will not code that entry in any TOC.XML until that notification is addressed by the user
- [ ] IF more than one back matter component, the BCMS places the component at the top of the Back unit and provides a notification (on the display page and by email?) that it is unable to place the document per supported automatic rules AND will not code that entry in any TOC.XML until that notification is addressed by the user
- [ ] IF support for parts is selected by the user AND the user adds parts, the BCMS places the component at the top of the Body unit and provides a notification (on the display page and by email?) that it is unable to place the document per supported automatic rules AND will not code that entry in any TOC.XML until that notification is addressed by the user**
-
IF support for parts is selected, user can place their component in the part they created and wishes that component to belong, and then that component will be autosorted withing the part it was added by any selected auto-sorting rules or manually sorted within that part if a manual order is selected -
IF support for parts is selected by the user, user can still have a component in the body that does not belong to any part
- [ ] Users must resolve any notifications that the system does not know how to place a componet (even if it is ticking an "I accept where it is placement) before a TOC.XML is sent for publication - OR SIMPLIFICATION PHASE 1, ALL CHAPTER-PROCESSED BOOKS REQUIRE PREVIEW APPROVAL OF ALL CHAPTER COMPONENTS AND A SINGLE TOC.XML APPROVAL ACKNOWLEDGEMENT)