DAW/furt

Fork

You've already forked furt

Code Issues 11 Pull requests Projects Releases 3 Packages 1 Wiki Activity Actions

Documentation: Create Installation Directory Standards Guide #95

New issue

Closed

opened 2025-08-30 20:05:25 +02:00 by michael · 1 comment

michael commented

2025-08-30 20:05:25 +02:00

Owner

Copy link

Dokumentation: Linux/BSD Installation Directory Standards

Zusammenfassung der Research aus Issue #71 und #94 in strukturierte Dokumente.

Problem:

Wir haben umfangreiche Research zu Installation-Pfaden durchgeführt:

Issue #71: Config-Pfade (OpenBSD vs Linux unterschiede)
Issue #94: Binary- und Library-Pfade (Distribution-Matrix)

Aber: Knowledge ist in Issues verstreut → schwer auffindbar für Entwicklung

Lösung: Standard-Pfade-Dokumentation

Dokument 1: Vollständige Dokumentation

Pfad: docs/meta/meta-installation-paths.md

Inhalt:

Distribution-Matrix (OpenBSD, Debian, Arch, FreeBSD, etc.)
Pfad-Kategorien (binary, config, library, data, logs)
Best-Practice-Empfehlungen
Makefile-Templates für verschiedene OS
Runtime-Detection-Patterns
Paketmanager-Integration-Hinweise

Dokument 2: Essenz für Claude-Context

Pfad: docs/meta/meta-installation-paths-essenz.md

Inhalt:

Kompakte Tabelle: OS → Standard-Pfade
Detection-Order-Empfehlung
Quick-Reference für DAW-Projekte
Makefile-Snippets

Research-Basis:

Issue #71: /etc/ vs /usr/local/etc/ (BSD vs Linux)
Issue #94: Binary-Pfade /usr/local/bin/ (universell)
Issue #94: Library-Pfade /usr/local/lib/ + Lua-Module-Pfade
Merkwerk-Makefile-Experience (praktische Validation)

Nutzen:

Für furt: Sichere Installation-Pfade definieren
Für alle DAW-Projekte: Wiederverwendbare Installation-Standards
Für Open-Source: Distribution-gerechte Packages erstellen
Für Claude: Schneller Context-Zugriff auf Standards

Akzeptanzkriterien:

meta-installation-paths.md mit vollständiger Distribution-Matrix
meta-installation-paths-essenz.md für Quick-Reference
Cross-References zu Issue #71 und #94
Beispiel-Makefile-Snippets für jedes OS
Detection-Code-Patterns (Shell + Lua)

Aufwand: Medium (Research ist komplett, nur strukturieren)

Priorität: High (blockiert saubere furt-Installation)

Status: Ready to implement - Research aus #71 und #94 zusammenfassen

## Dokumentation: Linux/BSD Installation Directory Standards **Zusammenfassung der Research aus Issue #71 und #94 in strukturierte Dokumente.** ### **Problem:** Wir haben umfangreiche Research zu Installation-Pfaden durchgeführt: - **Issue #71:** Config-Pfade (OpenBSD vs Linux unterschiede) - **Issue #94:** Binary- und Library-Pfade (Distribution-Matrix) **Aber:** Knowledge ist in Issues verstreut → schwer auffindbar für Entwicklung ### **Lösung: Standard-Pfade-Dokumentation** #### **Dokument 1: Vollständige Dokumentation** **Pfad:** `docs/meta/meta-installation-paths.md` **Inhalt:** - Distribution-Matrix (OpenBSD, Debian, Arch, FreeBSD, etc.) - Pfad-Kategorien (binary, config, library, data, logs) - Best-Practice-Empfehlungen - Makefile-Templates für verschiedene OS - Runtime-Detection-Patterns - Paketmanager-Integration-Hinweise #### **Dokument 2: Essenz für Claude-Context** **Pfad:** `docs/meta/meta-installation-paths-essenz.md` **Inhalt:** - Kompakte Tabelle: OS → Standard-Pfade - Detection-Order-Empfehlung - Quick-Reference für DAW-Projekte - Makefile-Snippets ### **Research-Basis:** - **Issue #71:** `/etc/` vs `/usr/local/etc/` (BSD vs Linux) - **Issue #94:** Binary-Pfade `/usr/local/bin/` (universell) - **Issue #94:** Library-Pfade `/usr/local/lib/` + Lua-Module-Pfade - **Merkwerk-Makefile-Experience** (praktische Validation) ### **Nutzen:** - **Für furt:** Sichere Installation-Pfade definieren - **Für alle DAW-Projekte:** Wiederverwendbare Installation-Standards - **Für Open-Source:** Distribution-gerechte Packages erstellen - **Für Claude:** Schneller Context-Zugriff auf Standards ### **Akzeptanzkriterien:** - [ ] `meta-installation-paths.md` mit vollständiger Distribution-Matrix - [ ] `meta-installation-paths-essenz.md` für Quick-Reference - [ ] Cross-References zu Issue #71 und #94 - [ ] Beispiel-Makefile-Snippets für jedes OS - [ ] Detection-Code-Patterns (Shell + Lua) ### **Aufwand:** Medium (Research ist komplett, nur strukturieren) ### **Priorität:** High (blockiert saubere furt-Installation) **Status:** Ready to implement - Research aus #71 und #94 zusammenfassen

michael added the

labels 2025-08-30 20:05:25 +02:00

michael commented

2025-08-30 20:15:25 +02:00

Author

Owner

Copy link

Issue #95 Complete - Installation Directory Standards Documentation (2025-08-30)

Research aus Issue #71 und #94 erfolgreich in strukturierte Dokumente konsolidiert.

Deliverables Complete:

✅ Vollständige Dokumentation erstellt:

Datei: docs/meta/meta-installation-paths.md (2.800+ Zeilen)

Inhalt:

Distribution-Matrix (OpenBSD, FreeBSD, Debian, Arch, RHEL)
Pfad-Kategorien (binary, config, library, data, logs)
Runtime-Detection-Patterns (Shell + Lua)
Makefile-Templates für verschiedene OS
Distribution-spezifische Besonderheiten
Troubleshooting-Guide
Integration mit DAW-Projekten

✅ Essenz für Claude-Context erstellt:

Datei: docs/meta/meta-installation-paths-essenz.md

Inhalt:

Quick-Reference-Matrix (OS → Standard-Pfade)
Detection-Order-Standard
Standard-Makefile-Snippet
Service-Separation-Pattern

Key Standards Definiert:

Universal Standard: /usr/local/ PREFIX

✅ Funktioniert auf allen Systemen (BSD + Linux)
✅ Keine Paketmanager-Konflikte
✅ Standard für selbst-installierte Software

Distribution-spezifische Config-Pfade:

BSD-Familie: /usr/local/etc/
Linux-Familie: /etc/

Service-Separation-Pattern:

Separate Namespaces pro Service
furt: /usr/local/etc/furt/furt.conf
sagjan: /usr/local/etc/sagjan/sagjan.conf

Detection-Order standardisiert:

Development: ./bin/binary
Standard: /usr/local/bin/binary
System: /usr/bin/binary
PATH: command -v binary

Research-Basis:

Issue #71: Config-Pfade-Standards (4 Distributionen analysiert)
Issue #94: Binary- und Library-Pfade (Distribution-Matrix)
Praktische Validation: merkwerk-Makefile-Experience

Nutzen für DAW-Projekte:

furt: Sichere Installation-Pfade definiert
Alle DAW-Services: Wiederverwendbare Installation-Standards
Open-Source-Packages: Distribution-gerechte Strukturen
Claude-Context: Schnelle Referenz auf bewährte Standards

Akzeptanzkriterien Complete:

meta-installation-paths.md mit Distribution-Matrix ✅
meta-installation-paths-essenz.md für Quick-Reference ✅
Cross-References zu Issue #71 und #94 ✅
Makefile-Snippets für jedes OS ✅
Detection-Code-Patterns (Shell + Lua) ✅

Status: Ready for use in furt and all DAW-projects

Files Created:

docs/meta/meta-installation-paths.md
docs/meta/meta-installation-paths-essenz.md

## Issue #95 Complete - Installation Directory Standards Documentation (2025-08-30) **Research aus Issue #71 und #94 erfolgreich in strukturierte Dokumente konsolidiert.** ## Deliverables Complete: ### ✅ Vollständige Dokumentation erstellt: **Datei:** docs/meta/meta-installation-paths.md (2.800+ Zeilen) **Inhalt:** - Distribution-Matrix (OpenBSD, FreeBSD, Debian, Arch, RHEL) - Pfad-Kategorien (binary, config, library, data, logs) - Runtime-Detection-Patterns (Shell + Lua) - Makefile-Templates für verschiedene OS - Distribution-spezifische Besonderheiten - Troubleshooting-Guide - Integration mit DAW-Projekten ### ✅ Essenz für Claude-Context erstellt: **Datei:** docs/meta/meta-installation-paths-essenz.md **Inhalt:** - Quick-Reference-Matrix (OS → Standard-Pfade) - Detection-Order-Standard - Standard-Makefile-Snippet - Service-Separation-Pattern ## Key Standards Definiert: **Universal Standard:** /usr/local/ PREFIX - ✅ Funktioniert auf allen Systemen (BSD + Linux) - ✅ Keine Paketmanager-Konflikte - ✅ Standard für selbst-installierte Software **Distribution-spezifische Config-Pfade:** - BSD-Familie: /usr/local/etc/ - Linux-Familie: /etc/ **Service-Separation-Pattern:** - Separate Namespaces pro Service - furt: /usr/local/etc/furt/furt.conf - sagjan: /usr/local/etc/sagjan/sagjan.conf **Detection-Order standardisiert:** 1. Development: ./bin/binary 2. Standard: /usr/local/bin/binary 3. System: /usr/bin/binary 4. PATH: command -v binary ## Research-Basis: - **Issue #71:** Config-Pfade-Standards (4 Distributionen analysiert) - **Issue #94:** Binary- und Library-Pfade (Distribution-Matrix) - **Praktische Validation:** merkwerk-Makefile-Experience ## Nutzen für DAW-Projekte: - **furt:** Sichere Installation-Pfade definiert - **Alle DAW-Services:** Wiederverwendbare Installation-Standards - **Open-Source-Packages:** Distribution-gerechte Strukturen - **Claude-Context:** Schnelle Referenz auf bewährte Standards ## Akzeptanzkriterien Complete: - [x] meta-installation-paths.md mit Distribution-Matrix ✅ - [x] meta-installation-paths-essenz.md für Quick-Reference ✅ - [x] Cross-References zu Issue #71 und #94 ✅ - [x] Makefile-Snippets für jedes OS ✅ - [x] Detection-Code-Patterns (Shell + Lua) ✅ **Status:** Ready for use in furt and all DAW-projects **Files Created:** - docs/meta/meta-installation-paths.md - docs/meta/meta-installation-paths-essenz.md

michael

2025-08-30 20:15:27 +02:00

closed this issue
added
status
done
and removed
effort
medium
labels

michael added this to the v0.1.2 - Gateway Basics milestone 2025-08-30 21:12:33 +02:00

michael referenced this issue from a commit

2025-08-30 21:36:20 +02:00

docs(meta): add installation directory standards guide (DAW/furt#95)

No Branch/Tag specified

main

feature/structured-logging-health-monitoring

v0.1.4

v0.1.3

v0.1.2

generation-1-archive

debug-monster-anti-pattern

Labels

Clear labels

Rows
Columns