Docs changes requested in the PR

platform/core/src/log.js

@@ -17,8 +17,10 @@ const log = {
   },
   // Store the timing keys to allow knowing whether or not to log events
   timingKeys: {
-    // script time values are added before log is loaded, and the log
-    // shouldn't depend on the enums, so for this case recreate the string.
+    // script time values are added during the index.html initial load,
+    // before log (this file) is loaded, and the log
+    // can't depend on the enums, so for this case recreate the string.
+    // See TimingEnum for details
     scriptToView: true,
   },
 };

platform/core/src/types/TimingEnum.ts

@@ -1,8 +1,24 @@
 export enum TimingEnum {
+  // The time from when the users selects a study until the study metadata
+  // is loaded (and the display sets are ready)
   STUDY_TO_DISPLAY_SETS = 'studyToDisplaySetsLoaded',
+
+  // The time from when the user selects a study until any viewport renders
   STUDY_TO_FIRST_IMAGE = 'studyToFirstImage',
+
+  // The time from when display sets are loaded until any viewport renders
+  // an image.
   DISPLAY_SETS_TO_FIRST_IMAGE = 'displaySetsToFirstImage',
+
+  // The time from when display sets are loaded until all viewports have images
   DISPLAY_SETS_TO_ALL_IMAGES = 'displaySetsToAllImages',
-  SCRIPT_TO_VIEW = 'scriptToView',
+
+  // The time from when the user hits search until the worklist is displayed
   SEARCH_TO_LIST = 'searchToList',
+
+  // The time from when the html script first starts being evaluated (before
+  // any other scripts or CSS is loaded), until the time that the first image
+  // is viewed for viewer endpoints, or the time that the first search for studies
+  // completes.
+  SCRIPT_TO_VIEW = 'scriptToView',
 }