v0.1.0-alpha — Erste Vorabversion #197

v0.1.0-alpha — Erste Vorabversion

Kurzbeschreibung

• Dies ist die erste Vorabversion des Projekts zur „Digitalisierung im ambulanten Sektor". Zweck: frühes Feedback zu Konzept, Struktur und Basisinhalten einholen. Nicht für den produktiven Einsatz bestimmt.

Highlights / Was enthalten ist

• Initiale Projektstruktur mit TeX-Quellen (Hauptfokus des Repos).
• Basisdokumente und Beispielinhalte zur Demonstration der Struktur und Formatierung.
• README mit ersten Hinweisen zur Nutzung und zum Projektziel.
• Grundlegende Vorlagen/Layouts (z. B. Dokumentenklassen oder Style-Dateien), um weitere Inhalte aufzubauen.

Wichtige Hinweise

• Vorabversion: API-/Datei- und Verzeichnisstrukturen können sich zwischen den Vorab-Releases ändern.
• Nicht für Produktionszwecke geeignet; es können Fehler, fehlende Inhalte und unvollständige Texte/Layouts vorhanden sein.
• Kompatibilität: erwartet wird eine gängige TeX-Distribution (z. B. TeX Live oder MiKTeX). Einzelne Build-Skripte oder Dateinamen können sich noch ändern.

Bekannte Probleme (Auswahl)

• Inhalte sind teilweise Platzhalter oder unvollständig.
• Layouts und Styles benötigen weitere Anpassungen/Tests (Druck-/PDF-Qualität, Margins, Schriften).
• Fehlende oder unvollständige Automatisierung (CI/Build-Skripte noch nicht eingerichtet).
• Mögliche Probleme mit unterschiedlichen TeX-Versionen oder Fonts.

Wie testen / lokal bauen

1. Repo klonen:
   git clone https://github.com/bsenst/praxis-it.git
2. Auf Tag wechseln (optional):
   git checkout tags/v0.1.0-alpha
3. TeX kompilieren:
   • Empfohlen: latexmk -pdf .tex
   • Alternativ: pdflatex / xelatex / lualatex, je nach verwendeten Paketen
     Hinweis: Ersetze .tex durch den tatsächlichen Namen der Haupt-TeX-Datei (siehe README).

Feedback / Fehlerberichte

• Bitte Issues im GitHub-Repository anlegen. Informationen, die beim Melden helfen:
  • Beschreibung des Problems / gewünschte Änderung
  • Schritte zur Reproduktion
  • Umgebung (Betriebssystem, TeX-Distribution und Version)
  • Logs / Fehlermeldungen / die betroffene .tex-Datei (oder Ausschnitt)
  • Optional: Screenshot oder generiertes PDF
• Bitte das Label "alpha" bzw. „vorab" verwenden, falls vorhanden.

Upgrade- und Versionshinweis

• Dieses Release ist als SemVer-Prä-Release markiert (v0.1.0-alpha). Erwarteter Ablauf: alpha → beta → rc → stabile 0.1.0.
• Änderungen an Dateinamen und Struktur sind bis zur stabilen Version möglich; bei Breaking Changes wird empfohlen, vor dem Update die Release-Notes zu prüfen.

Roadmap / Nächste Schritte

• Stabilisierung der Dokumentvorlagen und Inhalte.
• Aufbau einer CI-Pipeline zum automatischen Erzeugen von PDFs.
• Erweiterte Tests auf verschiedenen TeX-Distributionen und Systemen.
• Einholen und Einarbeiten von Feedback aus dieser Alpha-Phase.

Danksagung

• Danke an alle Mitwirkenden und frühen Tester, die Feedback liefern — das hilft, die Basisversion robust und gebrauchstauglich zu machen.