Playing with docs

.gitignore

@@ -30,4 +30,8 @@ Cargo.lock
 #  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
-#.idea/
+#.idea/
+
+# mdbook
+/docs/output
+/docs/src/scripts

scripts/1p-bridge

@@ -1,15 +1,20 @@
 #! /usr/bin/env python3
-"""1password bridge
+"""
+# `1p-bridge`: 1password bridge
 
 This script can expose the `op` cli utility as a web service.
 Callers can then pass a 1password service token through an HTTP request,
 and are able to read secrets from 1password.
 
+This allows the use of 1password as a basic secret store for self-hosted applications.
+
+```
 HTTP routes:
     /whoami
         GET: Returns the current user's information
     /read/<path:uri>
         GET: Reads the item at the specified URI
+```
 """
 
 import argparse

scripts/ableton-linux

@@ -1,4 +1,10 @@
 #! /usr/bin/env python3
+"""
+# `ableton-linux`: Ableton Wrapper for Linux
+
+This script handles the necessary setup and pre-configuration to run Ableton Live on Linux with low-latency audio.
+"""
+
 import argparse
 import os
 import sys

scripts/baofeng2gqrx

@@ -1,3 +1,5 @@
+#! /usr/bin/env python3
+
 import argparse
 import sys
 import csv

scripts/cursedecompiler

@@ -1,3 +1,5 @@
+#! /usr/bin/env python3
+
 import argparse
 import os
 from typing import *

scripts/lyrics2ptr

@@ -1,3 +1,5 @@
+#! /usr/bin/env python3
+
 import argparse
 import sys
 import re