Improving manual and readme

Author: Dennis Mantz

.github/workflows/deploy-docs.yml

@@ -26,4 +26,4 @@ jobs:
           restore-keys: |
             mkdocs-material-
       - run: pip install mkdocs-material pymdown-extensions
-      - run: mkdocs gh-deploy --force
+      - run: mkdocs gh-deploy --no-directory-urls --force

Readme.md

@@ -9,7 +9,7 @@ Whether you're a radio hobbyist, ham operator, or just curious about what's
 flying through the airwaves, RF Analyzer makes exploring the RF world from your
 phone both practical and fun.
 
-![RF Analyzer Screenshot](todo)
+![RF Analyzer Screenshot](./resources/graphics/appstore/feature_graphic.png)
 
 ---
 
@@ -41,7 +41,7 @@ phone both practical and fun.
 
 A full **user manual** is available in the `docs/` folder and online via MkDocs:
 
-[**Read the RF Analyzer Manual**](todo)
+[**Read the RF Analyzer Manual**](https://demantz.github.io/RFAnalyzer/)
 
 Topics include:
 
@@ -59,7 +59,7 @@ Topics include:
 
 Get RF Analyzer on **Google Play**:
 
-[![Get it on Google Play](docs/assets/google-play-badge.png)](https://play.google.com/store/apps/details?id=com.mantz_it.rfanalyzer)
+[![Get it on Google Play](./docs/assets/google_play_badge.png)](https://play.google.com/store/apps/details?id=com.mantz_it.rfanalyzer)
 
 The app is available as a **free trial**, giving you 7 days of usage after
 installation and up to 60 minutes of operation time. This allows you to fully
@@ -82,9 +82,8 @@ Hello, my name is Dennis Mantz and I greet you from Heidelberg in Germany! How
 to reach me:
 
 - Callsign: DM4NTZ
-- Mastodon: @dm4ntz@chaos.social
-- Blog: http://tech.mantz-it.com
-- Mail: rfanalyzerapp -at- gmail.com
+- Mastodon: [@dm4ntz@chaos.social](https://chaos.social/@dm4ntz)
+- Mail: rfanalyzerapp -at- gmail -dot- com
 
 ## License
 

docs/assets/rtlsdr_demodulation_tab_fm.png

@@ -1,19 +1,36 @@
 # RF Analyzer 2.0 User Manual
 
-Welcome to the **RF Analyzer 2.0** user manual. This guide will help you to
-install, configure, and effectively use the app for spectrum analysis and
-signal demodulation.
+<div style="display: flex; align-items: center; flex-wrap: wrap;">
+  <div style="flex: 1; min-width: 250px;">
+    <p>
+      Welcome to the <b>RF Analyzer 2.0</b> user manual. This guide will help you to
+      install, configure, and effectively use the app for spectrum analysis and
+      signal demodulation.
+    </p>
+  </div>
+  <div style="flex-shrink: 0; margin-left: 20px; margin-top: 10px;">
+    <a href="https://play.google.com/store/apps/details?id=com.mantz_it.rfanalyzer">
+      <img src="./assets/google_play_badge.png" style="max-width: 100%; height: auto; width: 200px;" alt="Get it on Google Play">
+    </a>
+  </div>
+</div>
 
 ## Features
 - Real-time FFT & waterfall spectrum visualization
 - Support for **HackRF, RTL-SDR, and IQ file playback**
 - Adjustable SDR settings (frequency, gain, sample rate, etc.)
 - Analog signal demodulation (CW, AM, nFM, wFM, LSB, USB)
 
+<p float="left">
+  <img src="./assets/rtlsdr_source_tab.png" width="45%" />
+  <img src="./assets/rtlsdr_demodulation_tab_fm.png" width="45%" />
+</p>
+
 ### New in RF Analyzer 2.0
 - Complete rework of the app in a modern language (Kotlin) and with a modern Material Design based UI
 - Demodulation can run as **background service** without a foreground app
 - Significant performance improvements
+- Built-in context-aware help and a full offline in-app manual
 
 ---
 

docs/assets/rtlsdr_source_tab.png

@@ -10,7 +10,10 @@ section [SDR Source](./sdr-source.md).
 
 The app can be downloaded via the Google Play Store. Use the following link:
 
-[<img src="/assets/google_play_badge.png" alt="RF Analyzer on Google Play" width="200px">](https://play.google.com/store/apps/details?id=com.mantz_it.rfanalyzer)
+[https://play.google.com/store/apps/details?id=com.mantz_it.rfanalyzer](https://play.google.com/store/apps/details?id=com.mantz_it.rfanalyzer)
+
+<a href="https://play.google.com/store/apps/details?id=com.mantz_it.rfanalyzer"><p align="center"><img src="./assets/google_play_badge.png" alt="RF Analyzer on Google Play" width="200px"></p></a>
+
 
 You can try all features for free with a 7-day trial and up to 60 minutes of
 analyzer usage.
@@ -43,7 +46,7 @@ using a [USB OTG adapter](https://en.wikipedia.org/wiki/USB_On-The-Go). You
 might have received such an adapter with your phone as it is usually used to
 transfer data from you old phone to the new one.
 
-!!! warning "TODO: add image of OTG adapter and connected sdr"
+![](./assets/tutorial_connect_sdr.png)
 
 When connecting the SDR, the RTL-SDR driver app immediatly shows a dialog
 requesting permissions to the device.
@@ -68,9 +71,7 @@ Select **RTL-SDR** in the source tab dropdown menu in the RF Analyzer app.
 Before starting the analyzer, scroll down and enable **External Server**.
 Enter the IP address and port:
 
-!!! warning "TODO: screenshot"
-
-Afterwards, start the analyzer by pressing the **Play** Button ().
+Afterwards, start the analyzer by pressing the **Play** Button.
 
 !!! warning "Firewall might block access to the server"
     If your host computer is behind a firewall or has a local firewall