From 1c611f424c8cadc8bf932219965bdfac4af2db0c Mon Sep 17 00:00:00 2001
From: Archie <60907848+suorcd@users.noreply.github.com>
Date: Sat, 18 Nov 2023 14:01:10 -0800
Subject: [PATCH] initial thoughts on structure updates

---
 docs/how-to-publish-podverse-fdroid-beta.md | 69 +++++++++++++++++----
 1 file changed, 56 insertions(+), 13 deletions(-)

diff --git a/docs/how-to-publish-podverse-fdroid-beta.md b/docs/how-to-publish-podverse-fdroid-beta.md
index 18b303549..7270c9d2c 100644
--- a/docs/how-to-publish-podverse-fdroid-beta.md
+++ b/docs/how-to-publish-podverse-fdroid-beta.md
@@ -1,15 +1,58 @@
 # How to publish Podverse for F-Droid Beta
 
-1) Get file in the right spot with the correct permissions.
-    1) Get the APK from the master-beta pipeline.
-    2) Change the name of the APK to be `com.podverse.fdroid_${versionCode}.apk`
-    3) Connect to `jammy-pv00` via ssh.
-    4) Upload the APK to `jammy-pv00` in the `/home/pv-f-droid/fdroid/repo`.
-    5) Check the hash is correct for the file on the server: `md5sum ${filename}`
-    6) Move the file to the beta fdroid repo: `mv com.podverse.fdroid_1700281421.apk /home/pv-f-droid/fdroid/repo/`
-    7) Give the `pv-f-droid` user ownership of the APK: `chown pv-f-droid /home/pv-f-droid/fdroid/repo/com.podverse.fdroid_1700281421.apk`
-2) Update the metadata
-    1) Update the `description.txt` file to contain the latest release notes at: `/home/pv-f-droid/fdroid/metadata/com.podverse.fdroid/en-US/description.txt`
-3) Change user to `pv-f-droid`: `su -l pv-f-droid`.
-4) From the `/home/pv-f-droid/fdroid` directory, run `fdroid update`
-5) From the `/home/pv-f-droid/fdroid` directory, run `fdroid deploy`
+## File import
+
+Get file in the right spot with the correct owernship and permissions.
+
+Repo Dir: `/home/pv-f-droid/fdroid/repo`
+
+Owner: `pv-f-droid`
+
+filename: `com.podverse.fdroid_${versionCode}.apk`
+
+### As root
+
+1) Get the APK from the master-beta pipeline.
+2) Change the name of the APK to be `com.podverse.fdroid_${versionCode}.apk`
+3) Connect to `jammy-pv00` via ssh.
+4) Upload the APK to `jammy-pv00` in the `/home/pv-f-droid/fdroid/repo`.
+5) Check the hash is correct for the file on the server: `md5sum ${filename}`
+6) Move the file to the beta fdroid repo:
+
+```
+mv com.podverse.fdroid_${versionCode}.apk /home/pv-f-droid/fdroid/repo/
+```
+
+7) Change the `pv-f-droid` user ownership of the APK: 
+
+```
+chown pv-f-droid /home/pv-f-droid/fdroid/repo/com.podverse.fdroid_${versionCode}.apk
+```
+
+## F-Droid Server
+
+### Update the metadata
+
+Update the `description.txt` file to contain the latest release notes at: `/home/pv-f-droid/fdroid/metadata/com.podverse.fdroid/en-US/description.txt`
+
+### pv-f-droid user
+
+Change user to `pv-f-droid`: `su -l pv-f-droid`.
+
+#### F-Droid server update
+
+From the `/home/pv-f-droid/fdroid` directory, run `fdroid update`
+
+```
+cd /home/pv-f-droid/fdroid
+fdroid update
+```
+
+#### F-Droid server deploy
+
+From the `/home/pv-f-droid/fdroid` directory, run `fdroid deploy`
+
+```
+cd /home/pv-f-droid/fdroid
+fdroid deploy
+```
\ No newline at end of file