From 8620a5a43b105ffa666ea86c183f5fab4b6b9ce2 Mon Sep 17 00:00:00 2001
From: rxhfcy <42669366+rxhfcy@users.noreply.github.com>
Date: Sat, 6 Apr 2024 17:38:23 +0300
Subject: [PATCH] README.md: add high-level technical explanation, tweak

---
 README.md | 18 ++++++++++--------
 1 file changed, 10 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 41f1954..b694aed 100644
--- a/README.md
+++ b/README.md
@@ -40,6 +40,15 @@ The app can also be used to change the default Startup Disk directly from the me
 3. Navigate to the new folder (Xcode will automatically look for and open the `.xcodeproj` file)
 4. You should now be able to build and test the project (please open a new issue if that was not the case!)
 
+## High-level technical explanation:
+
+The app adds a menu bar icon that offers a convenient way to first use `bless --nextboot` so set the temporary Startup Disk for this restart only, and then restarts.
+
+So basically a pretty GUI for the following:
+1. Runs `sudo bless --mount "/Volumes/Linux Disk Name/" --setBoot --nextonly`
+2. Then restarts the computer relatively gracefully
+   - the app is not allowed to use the system restart dialog directly, but restarting seems to honor the previously selected "Reopen windows when logging back in" setting (todo: test thoroughly before promising anything)
+
 ## Download initial demo version:
 
 Download:  
@@ -65,14 +74,7 @@ Download:
 - Don't be stupid
 - Keep it simple
 - Use non-technical language (give newbies a chance, experts will know how to use the app regardless of word choices)
-- Hide implementation details, but if the user explicitly wants to know how and why, explain in a help dialog:
-    - "this app uses Apple's official 'bless' tool with --nextonly to temporarily make e.g. Linux load after restarting 
-       next time (i.e. without having to change the default Startup Disk value)"
-    - bonus: teach the possibility of using "sudo bless --mount "/Volumes/Asahi Linux" --setBoot --nextonly" in 
-      Terminal.app and then restarting normally -> change OS for next time only
-    - bonus: teach newbies the essential skill of holding down the power button to get to boot picker (show animation?) 
-    - bonus: mention the Linux version of this tool (todo) and "Linux bless"
-      (sudo dnf install asahi-bless && sudo asahi-bless)
+- Hide implementation details, but if the user explicitly wants to know how and why, explain in the help dialog
     
 ## Stretch goals:
 - Somehow convince official Asahi installer to automatically install this app (icon in user's macOS menubar)