Open martindholmes opened 2 years ago
Some work has already been completed in code/diagnostics/diagnostics_text.xsl.
I've added the current text-level diagnostics processing as the default transformation for LEMDO XML files.
In rev 16313, I added a listing of entrances and exits.
In rev 17367, I added proper handling for milestone act and scene divisions for entrances and exits.
@JanelleJenstad @LEMDO-PM I need to get your input on this ticket at this stage. Some of the remaining items (such as tables of entrances and exits) cannot be done with additional encoding which doesn't yet exist (such as stage/@who), while others such as cue scripts are going to be massive -- the diagnostics would be longer than the play itself -- so I think they should be a separate feature request handled in a different process. Links to non-published documents will not typically appear in play texts, they'll be in ancillary files, so this suggests that this diagnostic is not just for play texts but for any files; is that right? Would that be better handled by a diagnostic across the whole collection?
Over the vacation I added diagnostics for unused anchors and pointers to non-existent anchors; this is crucial to prevent committing of files which are not invalid, but which will result in build breaks.
@JanelleJenstad @LEMDO-PM Ping on this -- any response?
I'll leave the April comment to Janelle who knows more about what we want for the long-term LEMDO goals. Re: unused anchors and pointers, I think they're great and already coming in handy :)
We do want to be careful with the unused anchors diagnostic--it only looks within a single edition, right? And we might have people linking to an anchor in one edition from a different edition (i.e., some anchors may be being used even if we can't see that within the edition itself).
For myself and Janelle, we'll need to start teaching people to use those diagnostics. I think most people don't know they exist, so really don't know how to use them. It'll be a combo of writing documentation and incorporating it into training.
This is a list of nice-to-have features for a text-level diagnostic process, gathered from editors:
Please add any diagnostic requests here so we can develop feature requests for our developer.
Working Diagnostics
Text Analysis
From B G-H: