docs: reorder sections (Install/Completion/Usage/Related); refresh banner

README sections reordered to the canonical sibling-tool layout: Install,
Shell completion, Usage, Related. Adds a Usage section showing the
common `--list`, `--bind`, and `--unbind` invocations along with a
sample `--list` output that includes the memlock limits block. Banner
SVG regenerated from ~/git/banners so the tagline matches the current
pyproject description ("Inspect and control PCI device-driver binding
in Linux"). Bumps __version__ to 0.3.6.

Signed-off-by: Simon A. F. Lund <os@safl.dk>

Author: safl

README.md

@@ -29,6 +29,29 @@ devbind --print-completion bash > ~/.local/share/bash-completion/completions/dev
 
 Open a new shell (or `source` the file) and tab-completion is live: `devbind --bind <TAB>` lists `nvme vfio-pci vfio-noiommu uio_pci_generic`.
 
+## Usage
+
+```
+devbind --list                                       # list NVMe devices and their drivers
+sudo devbind --bind vfio-pci --device 0000:01:00.0   # bind one device to vfio-pci
+sudo devbind --bind nvme --device 0000:01:00.0       # rebind to the native driver
+sudo devbind --unbind --device 0000:01:00.0          # unbind without rebinding
+```
+
+`devbind --list` sample output:
+
+```
+system:
+  drivers:
+  - nvme: {'available': True}
+  - uio_pci_generic: {'available': True}
+  - vfio-noiommu: {'available': False}
+  - vfio-pci: {'available': True}
+  limits:
+    memlock_soft: unlimited
+    memlock_hard: unlimited
+```
+
 ## Related
 
 - [`iommu`](https://github.com/safl/iommu): inspect and configure the IOMMU isolation level in Linux.

assets/banner.svg

@@ -39,7 +39,7 @@
 from pathlib import Path
 from dataclasses import dataclass, asdict, field
 
-__version__ = "0.3.5"
+__version__ = "0.3.6"
 
 PCIE_DEFAULT_CLASSCODE = 0x0108  # Mass Storage - NVM