Adding feedback form.

Author: Jacek Gębal

docs/assets/topbar.js

@@ -258,6 +258,14 @@
     });
   }
 
+  function rewriteFeedbackLink() {
+    var title = encodeURIComponent('Doc feedback: ' + document.title);
+    var body = encodeURIComponent('Page: ' + location.href + '\n\nWhat could be improved:\n');
+    document.querySelectorAll('.md-feedback a[href*="discussions/new"]').forEach(function (a) {
+      a.href = 'https://github.com/utPLSQL/utPLSQL/discussions/new?category=documentation-feedback&title=' + title + '&body=' + body;
+    });
+  }
+
   /* Hide Material's built-in header controls immediately to prevent a flash
      where logo/palette appear before the topbar is painted. */
   ensureStyle();
@@ -273,14 +281,16 @@
   applyScheme(effectiveScheme(getPreference()));
 
   if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', inject);
+    document.addEventListener('DOMContentLoaded', function () { inject(); rewriteFeedbackLink(); });
   } else {
     inject();
+    rewriteFeedbackLink();
   }
 
   /* Material instant navigation — fires after each page swap. */
   if (typeof document$ !== 'undefined') {
     document$.subscribe(inject);
+    document$.subscribe(rewriteFeedbackLink);
   }
   /* Fallback: browser history navigation */
   window.addEventListener('popstate', updateActiveLink);

mkdocs.yml

@@ -48,6 +48,20 @@ extra:
   analytics:
     provider: google
     property: G-WMFVR98J0Q
+    feedback:
+      title: Was this page helpful?
+      ratings:
+        - icon: material/emoticon-happy-outline
+          name: This page was helpful
+          data: 1
+          note: >-
+            Thanks for your feedback!
+        - icon: material/emoticon-sad-outline
+          name: This page could be improved
+          data: 0
+          note: >-
+            Thanks for your feedback! Help us improve this page by
+            using our <a href="https://github.com/utPLSQL/utPLSQL/discussions/new?category=documentation-feedback" target="_blank" rel="noopener noreferrer">GitHub Discussions</a>.
   social:
     - icon: fontawesome/brands/twitter
       link: https://twitter.com/utPLSQL