docs: convert README.md to landing page on bookworm

This commit is contained in:
Steve Zingman 2026-07-09 15:57:09 -04:00
parent 1294ff32be
commit dbc4c58f56

View file

@ -1,46 +1,9 @@
# DVSwitch Filesystem-Mirror
# Analog_Bridge
## Purpose
This repository contains two documents of interest:
This repository is a **filesystem-mirror** — a pure representation of the
DVSwitch package contents as they would appear on a Debian Linux filesystem.
- **[Analog_Bridge.md](Analog_Bridge.md)** — Application overview, deployment, and configuration guide. *(Coming soon)*
- **[DVSwitch Filesystem-Mirror.md](DVSwitch%20Filesystem-Mirror.md)** — Repository structure and purpose.
Unlike traditional packaging repositories that carry debian packaging metadata
(`DEBIAN/`, control files, maintainer scripts), this repository strips all
packaging metadata and maps directly to the target filesystem paths.
## Structure
Every file is placed at its intended target path, rooted at the repository root:
```
etc/ → /etc/ (configuration files, logrotate configs)
lib/ → /lib/ (systemd service units)
opt/ → /opt/ (binaries, application data)
usr/ → /usr/ (scripts, libraries, shared data)
var/ → /var/ (runtime data, language files, talkgroup lists)
```
## Architecture-Specific Binaries
Architecture-specific ELF binaries follow a `.arch` suffix convention:
- `foo.amd64` — x86_64
- `foo.arm64` — aarch64
- `foo.armhf` — ARM hard-float
- `foo.i386` — x86
The **amd64** variant is authoritative for configuration and data files;
other architectures contribute only architecture-specific ELF binaries.
## Branches
| Branch | Purpose |
|--------|---------|
| `bookworm` | Filesystem-mirror for Debian 12 bookworm |
| `development` | Development branch (tracks bookworm) |
## Origin
Binaries and configuration files in this repository were extracted from
Debian `.deb` packages built by [DVSwitch](https://github.com/DVSwitch).
Default branch: `bookworm` (filesystem-mirror content)
Development branch: `development` (app documentation)