Improved Documentation and Code Comments

wp-content/plugins/tdf-progress-bar/css/progress.css

@@ -1,19 +1,22 @@
+/* Reading progress indicator: fixed thin bar at top of viewport showing read progress */
 #tdf-reading-progress {
-  position: fixed;
-  top: 0;
-  left: 0;
-  width: 0;
-  height: 4px;
-  z-index: 100000;
-  transition: width 0.08s linear;
+  position: fixed; /* fixed to viewport */
+  top: 0; /* sits at very top unless admin bar present */
+  left: 0; /* starts at left edge */
+  width: 0; /* updated via JS to indicate progress */
+  height: 4px; /* thin visible bar */
+  z-index: 100000; /* ensure above most content */
+  transition: width 0.08s linear; /* smooth width animation */
 }
 
 .admin-bar #tdf-reading-progress {
+  /* shift down when WP admin bar is visible */
   top: 32px;
 }
 
 @media screen and (max-width: 782px) {
   .admin-bar #tdf-reading-progress {
+    /* taller admin bar on small screens */
     top: 46px;
   }
 }

wp-content/themes/the-digital-front-child/acf-json/group_opinion_fields.json

@@ -7,22 +7,25 @@
       "label": "Author Bio",
       "name": "author_bio",
       "type": "textarea",
-      "required": 0
+      "required": 0,
+      "instructions": "Short author bio shown on opinion posts (keeps to ~50 words)"
     },
     {
       "key": "field_pull_quote",
       "label": "Pull Quote",
       "name": "pull_quote",
       "type": "textarea",
-      "required": 0
+      "required": 0,
+      "instructions": "Optional short pull quote used in opinion listings and cards"
     },
     {
       "key": "field_related_article",
       "label": "Related Article",
       "name": "related_article",
       "type": "relationship",
       "post_type": ["article"],
-      "required": 0
+      "required": 0,
+      "instructions": "Select an `article` to link this opinion to for context"
     }
   ],
   "location": [