Phase 7.5: language unification + Doxygen + Phase 8 Hybrid MVP strategy #5
Reference in New Issue
Block a user
No description provided.
Delete Branch "dev"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Summary
Bridges Phase 7 (porting complete) → Phase 8 (CGAL package). Three atomic commits:
1️⃣ Language unification
All German natural-language text translated to English (code comments, test file headers, CI step names, 4 markdown documents). Proper nouns preserved.
2️⃣ Phase 7.5 infrastructure + Phase 8 design freeze
Doxyfile— CGAL-style minimal configurationcode/CMakeLists.txt—doctarget viafind_package(Doxygen QUIET)README.md,.gitignore— doc build instructions, output excludeddoc/api/cgal-package.md— full Phase 8 architecture design3️⃣ Phase 8 strategy refinement: Hybrid MVP
After cost/benefit re-evaluation distinguishing three goals (Port / CGAL / Research tool), strategy revised from full Phase 8 first to Hybrid MVP:
Net budget: ~4 weeks for port-complete + CGAL MVP, instead of 6–8 weeks for full Phase 8 + Phase 9.
Verification
cmake -S code -B buildconfigures cleanlycode/(were never tracked)Next after merge
Phase 8 MVP:
Conformal_map_traits.hconcept +Discrete_conformal_map.hwith_euclidean()entry only.Adds the Doxygen documentation pipeline as the bridge from Phase 7 (porting complete) to Phase 8 (CGAL package). Also captures the strategic Phase 8 decisions taken on 2026-05-19. Infrastructure ────────────── * Doxyfile — CGAL-style minimal configuration, HTML-only, INPUT=code/include + doc/, excludes deps/ and macOS Finder duplicates * code/CMakeLists — `doc` target via find_package(Doxygen QUIET); silently disabled if Doxygen is not installed * README — `cmake --build build --target doc` instructions * .gitignore — exclude doc/doxygen/ output Phase 8 strategic decisions (recorded in doc/api/cgal-package.md) ──────────────────────────────────────────────────────────────── * Submission to CGAL: pre-submission-ready, 12+ months horizon, MIT preserved * Mesh-type flexibility: generic FaceGraph + HalfedgeGraph * Parameter style: CGAL Named Parameters * Default kernel: Simple_cartesian<double> (status quo) * Architecture: 3-layer wrapper, no algorithm duplication * Acceptance test: Phase 9a (Inversive-Distance) as first new client CLAUDE.md updated with a compact Phase 8 decision table. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>chore: unify language to English across code, docs, and CIto Phase 7.5: language unification + Doxygen infrastructure + Phase 8 design freezeRe-evaluated cost/benefit of Phase 8 vs Phase 9 after distinguishing three concurrent goals: • Goal A (Port): ~90% done, ~3 weeks remaining • Goal B (CGAL): speculative, 12+ months, uncertain submission • Goal C (Tool): research utility with novel features Phase 8 full (3–4 weeks) would mostly serve Goal C plus optional Goal B. Phase 9 (3 weeks) finishes Goal A unconditionally. Building Phase 8 in full before Phase 9 risks 3-4 weeks of speculative architecture for a hypothetical CGAL submission. New strategy: Hybrid MVP. Phase 8 MVP (3–5 days): Conformal_map_traits.h concept + Default<Surface_mesh,K> Discrete_conformal_map.h ONE entry: _euclidean() 4 named parameters Theta-map, max_iter, tol, pin Concept-check header + Doxygen Phase 9a (3–5 days): Inversive-Distance vs MVP API = acceptance test Phase 9b + 9c (~2 weeks): Port truly complete Phase 8 extensions: Only on concrete trigger 8a.2 generic FaceGraph trigger: Polyhedron_3 user 8c full doc trigger: submission planned 8d CGAL-format tests trigger: submission planned 8e YAML pipeline orthogonal, any time Net committed budget: ~4 weeks for "port complete + CGAL MVP", not 6–8 weeks for full Phase 8 + Phase 9. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>Phase 7.5: language unification + Doxygen infrastructure + Phase 8 design freezeto Phase 7.5: language unification + Doxygen + Phase 8 Hybrid MVP strategy