docs update

README.md

@@ -1,6 +1,15 @@
 # Alpine Packages
 
-Alpine stable packaging for internal packages.
+Alpine stable packaging for internal packages. This repository carries selected
+upstream releases ahead of Alpine community packages when we need newer
+features, packaging fixes, or service layouts on the current Alpine branch.
+
+Packages are either source builds or binary repackages:
+
+- Source builds compile upstream source releases inside the Alpine build
+  environment and link against Alpine libraries.
+- Binary repackages wrap official upstream Linux release artifacts in Alpine
+  package metadata, OpenRC services, config defaults, and role subpackages.
 
 ```text
 https://code.factoring.digital/api/packages/public/alpine/v3.24/alpine-packages
@@ -8,10 +17,12 @@ https://code.factoring.digital/api/packages/public/alpine/v3.24/alpine-packages
 
 ## Available Packages
 
-- [SeaweedFS](packaging/alpine/local/seaweedfs/README.md): `seaweedfs`
+| Package | APK name | Package type | Purpose |
-- [GreptimeDB](packaging/alpine/local/greptimedb/README.md): `greptimedb`
+| --- | --- | --- | --- |
-- [LavinMQ](packaging/alpine/local/lavinmq/README.md): `lavinmq`
+| [SeaweedFS](packaging/alpine/local/seaweedfs/README.md) | `seaweedfs` | Binary repackaging of official upstream release tarballs | Ships current SeaweedFS features with Alpine OpenRC role splits. |
-- [Gitea](packaging/alpine/local/gitea/README.md): `gitea`
+| [GreptimeDB](packaging/alpine/local/greptimedb/README.md) | `greptimedb` | Source build from upstream release | Provides a current GreptimeDB build and component OpenRC packages before it is available from Alpine community. |
+| [LavinMQ](packaging/alpine/local/lavinmq/README.md) | `lavinmq` | Source build from upstream release | Provides a current LavinMQ build on Alpine 3.24 with matching Crystal support. |
+| [Gitea](packaging/alpine/local/gitea/README.md) | `gitea` | Binary repackaging of official upstream release binaries | Ships current Gitea releases with the expected Alpine runtime layout and OpenRC service. |
 
 ## Use In Production
 
@@ -53,10 +64,10 @@ packaging/alpine/local/<pkgname>/
 Currently packaged:
 
 ```text
-seaweedfs    SeaweedFS 4.31 release binary and OpenRC role splits
+seaweedfs    SeaweedFS 4.31 binary repackaging and OpenRC role splits
-greptimedb   GreptimeDB 1.1.2 built from source for x86_64
+greptimedb   GreptimeDB 1.1.2 source build for x86_64
-lavinmq      LavinMQ 2.9.1 built from source for x86_64
+lavinmq      LavinMQ 2.9.1 source build for x86_64
-gitea        Gitea 1.26.4 release binary and OpenRC service
+gitea        Gitea 1.26.4 binary repackaging and OpenRC service
 ```
 
 Local build output is written under: