Translation Progress Tracking
Relevant source files
The following files were used as context for generating this wiki page:
The Translation Progress Tracking system in the "The Architecture of Open Source Applications" (AOSA) Korean translation project is a structured methodology for converting, organizing, and verifying the multi-volume book series. The project scope involves translating four primary volumes—Volume 1, Volume 2, POSA (Performance of Open Source Applications), and 500 Lines or Less—into Markdown format while maintaining the original architectural insights and technical diagrams.
This system ensures that the collaborative effort, involving dozens of volunteers, remains consistent across the directory structure and file naming conventions. It also manages the transition from remote resources to local assets, such as the systematic migration of nearly 400 images to facilitate offline reading and localized hosting.
Sources: CLAUDE.md:8-15, korean_translation/metadata/index.html.md:10-15, download_summary.md:4-8
Project Structure and Volumes
The translation effort is organized into specific directories corresponding to the original book volumes. Tracking progress requires verifying the presence and content of files within these specific paths.
| Directory | Content Description | File Count/Type |
|---|---|---|
volume1/ | 25 chapters covering applications like LLVM and Eclipse | 27 files (25 chapters + intro + bib) |
volume2/ | 24 chapters including Git, nginx, and SQLAlchemy | 26 files (24 chapters + intro + bib) |
posa/ | 12 chapters focusing on performance aspects | 17 files (12 chapters + intro + images) |
500lines/ | 22 chapters implementing systems in < 500 lines | 24 files (22 chapters + intro + test) |
metadata/ | Project-wide index, licensing, and FAQ | 6 files (index, buy, faq, license, etc) |
Sources: CLAUDE.md:19-33, CLAUDE.md:43-49
File Naming Conventions
A critical component of progress tracking is the standardized naming convention used to ensure sequential reading and automated processing: {chapter-number}_{chapter-name}.html.md.
{chapter-number}: A two-digit number (e.g.,00for introduction,01-25for chapters,99for bibliography).{chapter-name}: The kebab-case title of the chapter.
Sources: CLAUDE.md:36-41
Resource and Asset Migration
A major part of the translation progress involves the local hosting of technical diagrams and images to replace remote URLs from aosabook.org.
Image Download and Mapping Workflow
The project utilizes a multi-stage workflow to extract, download, and map images for the Korean translation.
The diagram shows the sequence of activities for migrating project assets.
Sources: download_summary.md:38-42, download_summary.md:52-57
Download Statistics Tracking
The translation project tracks the migration status of 395 images, achieving a 99% success rate. The remaining 1% (4 images) are identified as 404 errors related to hash-named khmer bioinformatics images that are no longer available on the source server.
Sources: download_summary.md:10-14, download_summary.md:44-50
Collaborative Contribution Management
The translation progress is managed through a decentralized model where volunteers coordinate with specific leads or the central coordinator (Greg Wilson).
Translation Status Workflow
Volunteers follow a specific lifecycle for translating chapters, starting with identification of missing content from the original FAQ and index files.
The sequence shows the communication and contribution flow between volunteers and project leads.
Sources: metadata/faq.html.md:27-30, metadata/index.html.md:300-308
Licensing and Attribution
Tracking requires strict adherence to the Creative Commons Attribution 3.0 Unported license. Every translated chapter must cite the original source and author(s) to maintain legal compliance.
Sources: metadata/faq.html.md:32-41, metadata/index.html.md:294-298
Metadata and Indexing
The project maintains a central index (korean_translation/metadata/index.html.md) that serves as the master checklist for translated chapters.
| Metadata Component | File Path | Purpose |
|---|---|---|
| Main Index | metadata/index.html.md | Table of contents for all volumes |
| Image Mapping | image_mapping.json | URL to local path mapping for tracking |
| FAQ | metadata/faq.html.md | Guidance on commercial use and contribution |
| Download Log | download.log | Detailed audit of asset migration |
Sources: CLAUDE.md:43-45, download_summary.md:32-37, metadata/faq.html.md:7-19
The translation progress tracking system ensures technical accuracy by strictly deriving content from the original source files while leveraging modern automation tools for asset management and repository organization.
Sources: CLAUDE.md:52-55, download_summary.md:59-65