From 8b92426c51919d666ddd2b43ea52f458366d63fa Mon Sep 17 00:00:00 2001
From: Stewart Allen <sa@grid.space>
Date: Thu, 23 May 2024 08:53:10 -0400
Subject: [PATCH] add html notes

---
 src/kiri/init.js    |  1 -
 web/kiri/index.css  |  7 -------
 web/kiri/index.html | 20 +++++++++++---------
 3 files changed, 11 insertions(+), 17 deletions(-)

diff --git a/src/kiri/init.js b/src/kiri/init.js
index f14a19a6..322d7a97 100644
--- a/src/kiri/init.js
+++ b/src/kiri/init.js
@@ -2791,7 +2791,6 @@ gapp.register("kiri.init", [], (root, exports) => {
 
         // bind interface action elements
         $('app-name').onclick = api.help.show;
-        $('app-state').onclick = (ev) => { ev.stopPropagation(); showDevices() };
         $('set-device').onclick = (ev) => { ev.stopPropagation(); showDevices() };
         $('set-profs').onclick = (ev) => { ev.stopPropagation(); api.conf.show() };
         $('set-tools').onclick = (ev) => { ev.stopPropagation(); showTools() };
diff --git a/web/kiri/index.css b/web/kiri/index.css
index 54f2cf07..7588a20b 100644
--- a/web/kiri/index.css
+++ b/web/kiri/index.css
@@ -494,13 +494,6 @@ th, tr, td, label {
     overflow: hidden;
 }
 
-#app-state {
-    position: absolute;
-    bottom: 0;
-    left: 0;
-    right: 0;
-    z-index: -1;
-}
 .chonk {
     margin: 10px 0 10px 0;
     height: 0px;
diff --git a/web/kiri/index.html b/web/kiri/index.html
index b6ef9a62..0affb886 100644
--- a/web/kiri/index.html
+++ b/web/kiri/index.html
@@ -28,10 +28,13 @@
 </head>
 <body>
 <div id="app" class="f-col">
+    <!-- hide page contents and provide loading message during initialization -->
     <div id="curtain" class="j-center a-center"><img id="loading">Kiri:Moto is Loading</div>
 
+    <!-- when running iframed, provide a separator between the menu bar and enclosing page -->
     <div id="top-sep"></div>
 
+    <!-- top menu bar -->
     <div id="top" class="f-row">
         <div class="f-row top-menu">
             <span id="view-arrange">
@@ -90,7 +93,7 @@
                         <div id="file-import">
                             <label lk="import">import</label>
                             <span><i class="fas fa-file-upload"></i></span>
-                            <!-- hidden file input loader -->
+                            <!-- required file input loader -->
                             <input id="load-file" type="file" name="loadme" style="display:none"></input>
                         </div>
                     </div>
@@ -239,6 +242,7 @@
         </div>
     </div>
 
+    <!-- line betwwen menu bar and main application windows -->
     <div id="top-mid-sep"></div>
 
     <div id="mid" class="grow f-row">
@@ -267,8 +271,10 @@
             <div class="chonk"></div>
         </div>
 
+        <!-- vertical separation between settings tray and workspace -->
         <div class="mid-sep"></div>
 
+        <!-- main workspace -->
         <div id="mid-mid" class="grow">
             <div id="modal">
                 <div id="modal-box" class="f-col">
@@ -446,10 +452,12 @@
             </div>
         </div>
 
+        <!-- allows right tray to slide/hide but still show speeds menu -->
         <div id="mid-right" class="f-row j-center">
             <div id="set-menu" class="f-col">
                 <div id="speeds"><div id="speedbar" class="f-col a-stretch j-center" lkt="sb_info"></div></div>
             </div>
+            <!-- vertical separation between workspace and right tray -->
             <div class="mid-sep"></div>
             <div id="right-work" class="f-col j-center slim-hide">
                 <div class="chonk"></div>
@@ -519,14 +527,6 @@
         <button id="context-setfocus" lk="rc_focs">set focus</button>
     </div>
 
-    <div id="app-state">
-        <!-- <div id="mode-info" class="f-row">
-            <label>Mode</label><div id="app-mode-name"></div>
-            <label>Device</label><div id="mode-device"></div>
-            <label>Profile</label><div id="mode-profile"></div>
-        </div> -->
-    </div>
-
     <!-- developer debugging -->
     <div id="stats">
         <div id="rms"></div>
@@ -545,10 +545,12 @@
         </div>
     </div>
 
+    <!-- slice/preview layer slider -->
     <div id="top-slider" class="f-col grow">
         <input id="anim-slider" type="range" min="0" max="1000" value="0"></input>
     </div>
 
+    <!-- movable tool tray for mesh tools -->
     <div id="float-tools" class="f-col movable hide">
         <div id="float-tools-title" class="title mover">
             <label id="ft-label" class="grow">title bar</label>