tractatus

john/tractatus

Fork 0

Commit graph

Author	SHA1	Message	Date
TheFlow	cfa57465de	feat(i18n): complete German and French translation implementation Translation Infrastructure Complete: - DeepL Pro API integration (2M+ chars translated) - All 22 documents translated to German (de) and French (fr) - 100% translation coverage across documentation - Query parameter URL strategy (?lang=de, ?lang=fr) Scripts & Tools: - Updated translate-all-documents.js with 5-second rate limiting - Added verify-translations.js for coverage verification - Batch translation workflow with dry-run and progress tracking Database: - 43 translations stored in MongoDB (22 docs × 2 langs - 1 existing) - Embedded translation schema with metadata tracking - Zero translation failures API Endpoints: - GET /api/documents/:identifier?lang={de\|fr} - GET /api/documents/:identifier/translations - POST /api/documents/:id/translate (admin) Testing: - All API endpoints verified and functional - Language fallback to English working correctly - Translation metadata tracking operational 🌐 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>	2025-10-26 01:30:15 +13:00
TheFlow	5e969bd4da	feat(docs): intelligent section recategorization + i18n infrastructure This commit includes two major improvements to the documentation system: ## 1. Section Recategorization (UX Fix) Problem: 64 sections (24%) were incorrectly marked as "critical" and displayed at the bottom of documents, burying important foundational content. Solution: - Created intelligent recategorization script analyzing titles, excerpts, and document context - Reduced "critical" from 64 → 2 sections (97% reduction) - Properly categorized content by purpose: - Conceptual: 63 → 138 (+119%) - foundations, "why this matters" - Practical: 3 → 46 (+1433%) - how-to guides, examples - Technical: 111 → 50 (-55%) - true implementation details UI Improvements: - Reordered category display: Critical → Conceptual → Practical → Technical → Reference - Changed Critical color from amber to red for better visual distinction - All 22 documents recategorized (173 sections updated) ## 2. i18n Infrastructure (Phase 2) Backend: - DeepL API integration service with quota management and error handling - Translation API routes (GET /api/documents/:slug?lang=de, POST /api/documents/:id/translate) - Document model already supports translations field (no schema changes) Frontend: - docs-app.js enhanced with language detection and URL parameter support - Automatic fallback to English when translation unavailable - Integration with existing i18n-simple.js system Scripts: - translate-all-documents.js: Batch translation workflow (dry-run support) - audit-section-categories.js: Category distribution analysis URL Strategy: Query parameter approach (?lang=de, ?lang=fr) Status: Backend complete, ready for DeepL API key configuration Files Modified: - Frontend: document-cards.js, docs-app.js - Backend: documents.controller.js, documents.routes.js, DeepL.service.js - Scripts: 3 new governance/i18n scripts Database: 173 sections recategorized via script (already applied) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-10-26 00:48:27 +13:00

Author

SHA1

Message

Date

TheFlow

cfa57465de

feat(i18n): complete German and French translation implementation

Translation Infrastructure Complete:
- DeepL Pro API integration (2M+ chars translated)
- All 22 documents translated to German (de) and French (fr)
- 100% translation coverage across documentation
- Query parameter URL strategy (?lang=de, ?lang=fr)

Scripts & Tools:
- Updated translate-all-documents.js with 5-second rate limiting
- Added verify-translations.js for coverage verification
- Batch translation workflow with dry-run and progress tracking

Database:
- 43 translations stored in MongoDB (22 docs × 2 langs - 1 existing)
- Embedded translation schema with metadata tracking
- Zero translation failures

API Endpoints:
- GET /api/documents/:identifier?lang={de|fr}
- GET /api/documents/:identifier/translations
- POST /api/documents/:id/translate (admin)

Testing:
- All API endpoints verified and functional
- Language fallback to English working correctly
- Translation metadata tracking operational

🌐 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-26 01:30:15 +13:00

TheFlow

5e969bd4da

feat(docs): intelligent section recategorization + i18n infrastructure

This commit includes two major improvements to the documentation system:

## 1. Section Recategorization (UX Fix)

**Problem**: 64 sections (24%) were incorrectly marked as "critical" and
displayed at the bottom of documents, burying important foundational content.

**Solution**:
- Created intelligent recategorization script analyzing titles, excerpts,
  and document context
- Reduced "critical" from 64 → 2 sections (97% reduction)
- Properly categorized content by purpose:
  - Conceptual: 63 → 138 (+119%) - foundations, "why this matters"
  - Practical: 3 → 46 (+1433%) - how-to guides, examples
  - Technical: 111 → 50 (-55%) - true implementation details

**UI Improvements**:
- Reordered category display: Critical → Conceptual → Practical → Technical → Reference
- Changed Critical color from amber to red for better visual distinction
- All 22 documents recategorized (173 sections updated)

## 2. i18n Infrastructure (Phase 2)

**Backend**:
- DeepL API integration service with quota management and error handling
- Translation API routes (GET /api/documents/:slug?lang=de, POST /api/documents/:id/translate)
- Document model already supports translations field (no schema changes)

**Frontend**:
- docs-app.js enhanced with language detection and URL parameter support
- Automatic fallback to English when translation unavailable
- Integration with existing i18n-simple.js system

**Scripts**:
- translate-all-documents.js: Batch translation workflow (dry-run support)
- audit-section-categories.js: Category distribution analysis

**URL Strategy**: Query parameter approach (?lang=de, ?lang=fr)

**Status**: Backend complete, ready for DeepL API key configuration

**Files Modified**:
- Frontend: document-cards.js, docs-app.js
- Backend: documents.controller.js, documents.routes.js, DeepL.service.js
- Scripts: 3 new governance/i18n scripts

**Database**: 173 sections recategorized via script (already applied)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-26 00:48:27 +13:00

2 commits