Skip to content

Doku-Site an aktuellen Projektstatus angepasst - #75

Merged
feurer98 merged 1 commit into
mainfrom
claude/docs-status-update
Jun 11, 2026
Merged

Doku-Site an aktuellen Projektstatus angepasst#75
feurer98 merged 1 commit into
mainfrom
claude/docs-status-update

Conversation

@feurer98

Copy link
Copy Markdown
Owner

Bringt die MkDocs-Site (https://feurer98.github.io/PIXEstL) auf den Stand nach den Review-PRs #72#74. 13 Dateien, nur Doku.

Faktische Korrekturen

  • Falscher Texturschicht-Dateiname überall korrigiert: Die Doku zeigte durchgehend layer-texture-White[PLA Basic].stl (Java-Altname) — tatsächlich heißt die Datei layer-texture.stl (Schnellstart, Generierung, Slicer, FAQ).
  • ARCHITECTURE.md als historisches Port-Planungsdokument gebannert (es beschreibt die Java-Analyse vor dem Port, inkl. „proposed" Dependencies) und das darin physikalisch invertierte Höhen-Mapping korrigiert: dunkel = dick (weniger Licht), nicht dünn; Defaults 0.3/1.8 mm statt 0.2/2.5 mm.
  • Dependency-Tabelle berichtigt: konzepte/architektur.md listete fünf Crates, die nicht in Cargo.toml existieren (nalgebra, stl_io, num_cpus, tracing, anyhow); jetzt die echten Abhängigkeiten inkl. vendored lib3mf-core.
  • Unbelegter „2–3× schneller"-Claim von der Startseite entfernt (konsistent mit README-PR README an aktuellen Projektstatus angepasst #74).
  • -o-Parameter: Endung wählt das Format (.3mf/.zip/Verzeichnis) statt „Ausgabe-ZIP"; Quellbild-Limit 16384×16384 dokumentiert.

Fehlende Inhalte ergänzt

  • Web-UI und 3MF-Export waren auf der publizierten Seite nirgends dokumentiert — jetzt: Feature-Karte auf der Startseite, Docker-Schnellstart-Tipp, 3MF-Abkürzung in Schnellstart/Slicer/FAQ/Parameter-Referenz (Bambu Studio weist AMS-Slots automatisch zu).
  • Navigation erweitert: „Web-UI & Docker", CLI-Referenz, beide Konzepte-Seiten und Best Practices existierten als Dateien, fehlten aber in der Nav (verwaiste Seiten).
  • Krümmungsmodus: Per-Pixel-Segmentierung (RLE aus, Platte/Texturboden segmentiert) und die größeren Dateien in Generierung, Parameter-Referenz, CLI-Referenz und Konzepte erklärt.
  • Manifold-Garantie in der Architektur-Seite dokumentiert; neue FAQ-Frage „Mein Slicer meldet Mesh-Fehler" (betrifft Nutzer älterer Versionen → aktualisieren und neu generieren).
  • deployment-docker.md: PIXESTL_JOB_TTL_SECS in der Env-Tabelle ergänzt; der veraltete Absatz „kein Job-TTL/Cleanup" durch den aktuellen Härtungsstand ersetzt (non-root-Container, RAM-Limit, Decode-Guard; offen bleiben CORS/Auth/Rate-Limit).
  • frontend/01+02: Härtungs-Status der V-MODEL-07-Punkte aktualisiert (TTL/Concurrency/Timeout/Guards umgesetzt).

Verifikation

mkdocs build --strict läuft fehlerfrei durch; alle neuen internen Links aufgelöst. Die einzig verbleibende layer-texture-<color>-Erwähnung steht bewusst in ARCHITECTURE.md (beschreibt das Java-Original, durch den Banner eingeordnet).

https://claude.ai/code/session_01UeFLMAr7coGKDio3eHjExB


Generated by Claude Code

Faktische Korrekturen:
- Texturschicht-Dateiname: ueberall layer-texture.stl statt des
  Java-Altnamens layer-texture-White[...].stl (Schnellstart,
  Generierung, Slicer, FAQ)
- ARCHITECTURE.md als historisches Port-Planungsdokument markiert und
  das invertierte Hoehen-Mapping korrigiert (dunkel = dick, nicht
  duenn; Defaults 0.3/1.8 statt 0.2/2.5)
- Dependency-Tabelle in konzepte/architektur.md gegen Cargo.toml
  berichtigt (nalgebra/stl_io/num_cpus/tracing/anyhow existieren
  nicht; lib3mf-core ergaenzt)
- index.md: unbelegter 2-3x-Speed-Claim entfernt
- -o-Parameter: Endung waehlt Format (.3mf/.zip/Verzeichnis) statt
  'Ausgabe-ZIP'; Quellbild-Limit 16384x16384 dokumentiert

Fehlende Inhalte ergaenzt:
- Web-UI und 3MF-Export waren auf der publizierten Seite nirgends
  dokumentiert: Feature-Karte auf der Startseite, Docker-Tipp im
  Schnellstart, 3MF-Abkuerzung in Schnellstart/Slicer/FAQ/Referenz
- Navigation erweitert: Web-UI & Docker, CLI-Referenz, Konzepte und
  Best Practices waren verwaiste Seiten ohne Nav-Eintrag
- Kruemmungsmodus: Per-Pixel-Segmentierung und groessere Dateien in
  Generierung/Referenz/CLI-Referenz/konzepte erklaert
- Manifold-Garantie-Hinweis in konzepte/architektur.md; neue
  FAQ-Frage zu Mesh-Reparatur-Warnungen aelterer Versionen
- deployment-docker.md: PIXESTL_JOB_TTL_SECS ergaenzt, veralteten
  'kein TTL/Cleanup'-Absatz durch aktuellen Haertungsstand ersetzt
  (non-root, RAM-Limit, Decode-Guard; offen: CORS/Auth/Rate-Limit)
- frontend/01+02: Haertungs-Status der V-MODEL-07-Punkte aktualisiert

mkdocs build --strict laeuft fehlerfrei durch.

https://claude.ai/code/session_01UeFLMAr7coGKDio3eHjExB
@feurer98
feurer98 merged commit b9994b4 into main Jun 11, 2026
18 checks passed
@feurer98
feurer98 deleted the claude/docs-status-update branch June 12, 2026 05:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants