doc: Restructure readme

Signed-off-by: Fini Jastrow <[email protected]>

Author: Finii

readme.md

@@ -25,25 +25,26 @@ The following flow diagram shows the current glyph sets included:
 </p>
 <sub><i>Diagram created using <a href="http://sankeymatic.com/" title="SankeyMATIC (BETA): A Sankey diagram builder for everyone">@SankeyMATIC</a></i></sub>
 
+## TL;DR
+  Nerd Fonts takes popular programming fonts and adds a bunch of Glyphs.
+  There is also a [font patcher](#font-patcher) available if your desired font isn't already patched.
+  For more high level information see the [wiki][wiki]. If you are looking for the Vim plugin see [VimDevIcons ➶][vim-devicons].
 
-## Important Notices
-* `master` branch file paths are **not** considered stable. [Verify your repository URI references](#unstable-file-paths)
-* cloning this repository is **not** recommended ([due to Repo size](#option-7-clone-the-repo)) unless you are going to be [contributing to development](#contributing)
-
+* `master` branch file paths are **not** considered stable. Verify your repository [URI references](#unstable-file-paths). Use links to the release archives if possible.
+* Cloning this repository is **not** recommended ([due to Repo size](#option-7-clone-the-repo)) unless you are going to be [contributing to development](#contributing).
 
-## Table of Contents
 
-[**TL;DR**](#tldr)
+## Quick links
 
-[**Installation Options**](#font-installation)
-  * [**1 - Release Archive Download**](#option-1-release-archive-download)
-  * [**2 - Homebrew Fonts (macOS (OS X))**](#option-2-homebrew-fonts)
-  * [**3 - Chocolatey or Scoop (Windows)**](#option-3-unofficial-chocolatey-or-scoop-repositories)
-  * [**4 - Arch Linux Repository (Extra, AUR)**](#option-4-arch-extra-repository)
-  * [**5 - Ad Hoc Curl Download**](#option-5-ad-hoc-curl-download)
-  * [**6 - Install Script**](#option-6-install-script)
-  * [**7 - Clone Repo**](#option-7-clone-the-repo)
-  * [**8 - Patch Your Own Font**](#option-8-patch-your-own-font)
+[**Installation Options**](#font-installation):
+  [Release Archive](#option-1-release-archive-download)
+  [Homebrew](#option-2-homebrew-fonts)
+  [Chocolatey or Scoop](#option-3-unofficial-chocolatey-or-scoop-repositories)
+  [Arch](#option-4-arch-extra-repository)
+  [Curl](#option-5-ad-hoc-curl-download)
+  [Install Script](#option-6-install-script)
+  [Clone Repo](#option-7-clone-the-repo)
+  [Selfpatch](#option-8-patch-your-own-font)
 
 [**Features**](#features)
   * [**Glyph/Icon sets**](#glyph-sets)
@@ -65,11 +66,6 @@ The following flow diagram shows the current glyph sets included:
   * [**License**](#license)
 
 
-## TL;DR
-  Nerd Fonts takes popular programming fonts and adds a bunch of Glyphs.
-  There is also a [font patcher](#font-patcher) available if your desired font isn't already patched.
-  For more high level information see the [wiki][wiki]. If you are looking for the Vim plugin see [VimDevIcons ➶][vim-devicons].
-
 ### Various Download Options for Fonts
 
 _If you..._
@@ -375,6 +371,8 @@ Patching the font of your own choosing:
   ```
 
 * Use docker
+The patcher's docker image is on [dockerhub][docker]. Note that the _About_ page with manual there is outdated;
+refer to the instructions given here.
   * Default parallel tasks
   ```
   docker run --rm -v /path/to/fonts:/in:Z -v /path/for/output:/out:Z nerdfonts/patcher [OPTIONS]
@@ -392,7 +390,7 @@ Patching the font of your own choosing:
 > [!NOTE]
 > The resulting font's family (aka font name) will be set to the original family after CamelCasing, removing whitespace and appending ` Nerd Font`. For example, `iosevka term` would become `IosevkaTerm Nerd Font`.
 
-Full options follow, see also [**page explaining all options**](https://github.com/ryanoasis/nerd-fonts/wiki/ScriptOptions):
+Full options follow, see also [**page explaining all options**][scriptoptions]:
 
 ```
 Nerd Fonts Patcher v3.1.0-6 (4.8.1) (ff 20230101)
@@ -645,6 +643,8 @@ Link References
 [coc]:https://github.com/ryanoasis/nerd-fonts/blob/-/code_of_conduct.md "Contributor Covenant Code of Conduct"
 [LICENSE]:https://github.com/ryanoasis/nerd-fonts/blob/-/LICENSE
 [prs]:http://makeapullrequest.com "Make a Pull Request (external link) ➶"
+[docker]:https://hub.docker.com/r/nerdfonts/patcher
+[scriptoptions]:https://github.com/ryanoasis/nerd-fonts/wiki/ScriptOptions
 
 <!--
 Font repos