← notes

Translating a curriculum made mostly of English links

Mar 30, 2021

Everything a person needs to get started or level up as a web developer, free, based on The Odin Project's open curriculum by Erik Trautman, credited throughout. Published as a GitBook and translated: codelibro in Spanish, codelivre in French.

The technical problem is the translation, and it is not the words. The curriculum is largely a sequence of links to the best free resources per topic, and almost all of those resources are in English. Translating the connective tissue while every destination stays English produces a book that reads fluently and then hands the learner a wall. Either you find equivalent resources per language, which means the three versions diverge in content rather than only language, or you accept the translation is a guide to English material.

Three separate repos means three separate structures, and a curriculum reordering in one does not propagate. Nothing marks the Spanish version as two revisions behind, so it silently is.

The third problem is format. GitBook’s markdown is not plain markdown, front matter and {% page-ref %} blocks are theirs, so the source is portable in the sense that the text survives, not that the book does.