From 108831895caa7b43ddd6f0ffd408e114c303e2e6 Mon Sep 17 00:00:00 2001
From: Josh Lay <me@jlay.us>
Date: Sun, 19 Oct 2025 12:42:55 -0500
Subject: [PATCH] README: highlight example, md, line break for ARC

---
 README.md | 28 ++++++++++++----------------
 1 file changed, 12 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index 53e0a7a..d5e2cac 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,4 @@
-zfs\_dkms
-=========
+# zfs\_dkms
 
 Ansible Role for installing [ZFS](https://zfsonlinux.org/)
 on [Fedora](https://openzfs.github.io/openzfs-docs/Getting%20Started/Fedora/index.html),
@@ -11,33 +10,30 @@ For pools/volumes, see:
 1. [community.general.zpool](https://docs.ansible.com/ansible/latest/collections/community/general/zpool_module.html)
 2. [community.general.zfs](https://docs.ansible.com/ansible/latest/collections/community/general/zfs_module.html)
 
-Requirements
-------------
+## Requirements
 
 None.
 
-Role Variables
---------------
+## Role Variables
 
 | Variable | Description | Role Default | Upstream Default |
 |----------|:------------|-------------:|-----------------:|
-| `zfs_dkms_arc_pct_min` | _Minimum_ physical memory (%) for ARC _(Adaptive Read Cache)_. | `0` | `0` |
+| `zfs_dkms_arc_pct_min` | _Minimum_ physical memory (%) for ARC<br />_(Adaptive Read Cache)_. | `0` | `0` |
 | `zfs_dkms_arc_pct_max` | _Peak_ physical memory (%) for ARC. | `16` | `0` |
 | `zfs_dkms_timeout` | Seconds to wait while rebooting `Fedora`, `RHEL`, or derivatives for kernel/header currency.<br />Skipped if the `zfs` kernel module is already loaded. | `3600` | _N/A_ |
 
-Dependencies
-------------
+## Dependencies
 
 1. `community.general`
 
-Example Playbook
-----------------
+## Example Playbook
 
-    - hosts: servers
-      roles:
-         - { role: zfs_dkms }
+```yaml
+- hosts: servers
+  roles:
+     - { role: zfs_dkms }
+```
 
-License
--------
+## License
 
 MIT