2026-08-24

The Grammar That Checked Itself

On Kaqchikel from the Ground Up: a textbook that promises its readers nothing it cannot prove, and mostly keeps its word. A review in eight audits, with an errata file for the second edition.

reviewing: /books/mayan · Kaqchikel from the Ground Up: A practical grammar and workbook of Kaqchikel Maya, with deep explanations

a-book-that-audits-itself

Self-published language textbooks are a genre with a deserved reputation: enthusiasm running ahead of evidence, paradigms remembered rather than verified, the air of a classroom handout that escaped. Kaqchikel from the Ground Up arrives with a different constitution. It is an English-language course in Kaqchikel Maya, twenty-six chapters and a set of appendices, delivered as a single offline web app with hover glosses, generated conjugation tables, and spaced-repetition flashcards. Its front matter names its printed authorities, Brown, Maxwell and Little's ¿La ütz awäch? and Salazar Tetzagüic's bilingual anthology of Kaqchikel literature, and behind the book sits something the front matter only hints at: a working corpus of more than a dozen sources, from the sixteenth-century Memorial de Sololá in Maxwell and Hill's interlinear edition to schoolbooks, dialect surveys, dictionaries, and a file of present-day Kaqchikel scraped from public Facebook posts. The author's stated rule is that no Kaqchikel form goes on the page unless the sources attest it or a stated rule derives it, and the project even ships a script whose one job is to flag words the corpus cannot vouch for.

A book like this invites the audit, and this review accepts the invitation. Eight independent passes were made through the text, one per block of chapters, and every checkable claim was taken back to the sources: each paradigm cell against Maxwell's reference grammar, each example sentence against the corpus, each dialect note against Patal Majzul's Variación Dialectal en Kaqchikel, each quoted line of literature against the anthology it cites. Nothing is called an error below unless a source can be quoted against it, with file and line. That discipline matters, because the first and most important finding is the one a hostile reviewer least wants to report.

what-survives

The engine room holds. The four-way aspect system, both sets of person markers, the rule that drops the r of ru- after an aspect prefix, the bridging vowel after xt- and n-, the harmonic echo vowel of the imperative, the passive and antipassive machinery, the entire positional system with its causatives and statives: all of it was checked cell by cell against Maxwell's grammar summary and against the professional morphological parses in the Kaqchikel Chronicles, and it agrees. Of the hundreds of inflected forms the audits took apart morpheme by morpheme, only a bare handful of outright conjugation errors survived scrutiny across the whole book, and each is correctable in a minute.

Better still, the book's most suspicious-looking claims kept turning out to be true. Ajsamaj glossed "daykeeper" rather than "worker" looked like a howler; the glossary confirms it. The bare intensifier xe "only", the archaic day-name glosses of the Cholq'ij sidebar, the shape-adjective plurals like tz'uyutz'äq, the claim that a polite refusal of thanks is literally "don't say it like that", the obscure anthology author "Marcelino Tavila" who smelled strongly of a typo: attested, attested, attested, attested, attested, usually verbatim. The number appendix, including the alarming high vigesimals up to juchuy 8,000, survives hostile checking cell by cell. When a reviewer sets out to catch a book inventing and instead keeps catching himself doubting things that are true, that is the strongest available evidence that the author worked from the corpus and not from memory. It is worth saying plainly: by the standards of this genre, the linguistic core of this book is unusually trustworthy.

Which is what makes the errors that do exist so interesting. They are not random. They fall into four families, and each family tells the second edition something different.

the-rainbow-at-evening

Begin with the plain mistakes, because some of them are lovely. Chapter 1, the chapter that teaches exactness, that warns the learner in bold that "the apostrophe is not optional", offers the evening greeting xoq'a without its final glottal stop, and then helpfully supplies a "fuller form", xokoq'a. The source's glossary knows that word. It means rainbow. The attested fuller greeting is xok aq'a'; the book has crossed it with xokoq'a' and produced a learner who bids the family goodnight by announcing meteorological phenomena. In the same chapter the "widespread variant" of rin "I" is given as yün, a form that occurs in no source and appears to be born of a single OCR misreading of the glossary's yïn; the ghost pronoun then walks again in Chapter 2. An exercise advertising minimal pairs offers pairs that differ in two and three segments, and its answer key asserts, of qab'i' and kib'i', that "the vowel is the same". It is not.

The same family of slips recurs at intervals throughout. Chapter 9 prints In nim raqän "I am tall" with a third-person possessor, against its own correct table forty lines later. Chapter 15 twice gives xik'o "I passed through" where the chapter's own paradigm requires xinik'o; as printed it means someone else did the travelling. Chapter 14's exercises conjure nuloq'o', an impossible hybrid that welds the imperative's echo vowel onto an incompletive verb, three times. Chapter 20 glosses Majun b'ey nutz'eton as "He has never seen the lake" when the prefix says I; the book glosses the identical form correctly in its own answer key. Chapter 25 tells you your cousin is your nuch'itichaq', "little younger sibling", collapsing precisely the same-sex, relative-age distinctions the chapter has just insisted are "one of the clearest signs of real competence"; the source lists the full cousin paradigm. And the market chapters gloss xerka as "jacket" when the source describes a man's woolen breechcloth, the rodillera worn over the trousers: a culturally salient garment mislabeled in the chapters that trade hardest on cultural texture.

Two errors in this family rise above the anecdotal, because they live in the reference apparatus, the part of the book "meant to be kept open while you read". Appendix A.4 prints potential-aspect forms, xtqatz'ët, xtkiya', that Chapter 13 explicitly stars as ungrammatical, and the corpus sides with Chapter 13; a learner who trusts the master table will produce forms the book's own exercises grade as wrong. And the dialect cheat sheet inverts the geography of ruma and roma "because of", assigning the majority form, used in Tecpán itself, the book's home dialect, to "older texts and K'iche'-influenced speech". The same sheet sends travellers to say ch'ima' for "chayote" without mentioning what the dialect survey states outright: that in most variants, to adults, the word means "vagina". A cheat sheet exists to prevent exactly that dinner-table incident.

the-letter-of-its-law

The second family is the one the book would least like discussed, because it concerns its own charter. The project's writing brief is admirably strict: linguistic facts may be taken from the sources, but the sources' illustrative sentences, dialogues and wording may not. Against that rule, the audits found a steady undertow of reuse. "Xtzaq qa pa b'ey, He fell down on the road", sentence and gloss, is the glossary's. "Where did you leave your sweater?", sweater and all, is Maxwell's. The bargaining line "Jotöl b'a rajil. Taqasaj jub'a'" is the source dialogue's. Across Chapters 15 to 22 the audits logged more than twenty verbatim or one-word-swapped lifts, and in Chapter 14 the practice caught the disease that proves the diagnosis: the book prints takolo' kan ri atzyaq with a missing ejective, character for character the OCR-mangled form of that sentence in the scanned source, while the book's own tables spell the verb correctly. You do not inherit another book's scanner error unless you copied the sentence.

One instance crosses from habit into something worse. Chapter 23 reproduces the source's conditional "Wi najin ta jäb' chwa'q, man xkojb'e ta", but quietly rewrites the source's translation, "if it rains tomorrow", as "if it should rain tomorrow", in order to support the book's claim that the particle ta adds tentativeness, a nuance the source nowhere teaches and its own parallel examples contradict. That is the single most serious editorial fact this review has to report: not a wrong form but doctored evidence, the one thing a book built on the promise of verification cannot afford. It is, as far as eight audits could determine, unique; it should not survive to a second printing, and the "tentative" doctrine should go with it or find real support.

attested-extrapolated-invented

The third family is subtler: the book has an honesty convention and keeps forgetting to use it. The brief requires a visible flag on any form the author could not verify. Chapter 17 shows the system working beautifully, hedging exactly where the corpus is thin. Elsewhere the discipline slips, and regular-but-unattested extrapolations are printed in the same confident type as corpus fact. Chapter 10's table of score numerals runs serenely from kawinäq 40 to lajwinäq 200 as though all were equal citizens, when the corpora attest only two of the column; the answer key then requires the unattested forms as model answers, while the fully attested k'al series sits one row away. The appendix prints fused spellings of relational nouns, chinuwäch, chiqaxe', that every source writes as two words. Chapter 16 builds plausible frames for "I feel cold" and "he has a fever" and then enters them in the vocabulary as plain fact. Chapter 21 offers a negative tag question no corpus contains. Chapter 22 invents a verb, nqachaq' qi' "we are siblings", by zero-converting a noun in a way Kaqchikel does not license. Meanwhile the flags that do exist have decayed into noise: of the twenty question-marked forms surviving in the book, most are attested in the very corpora on the author's disk, one marks a cross-reference that is correct, and the forms that genuinely deserve flags have none. The apparatus of doubt needs the same maintenance as the paradigm tables.

the-book-against-itself

The fourth family is disagreement between the book and itself, and it matters more than it sounds, because in a language course the model dialogues are the learner's primary evidence. Chapter 4 stakes its flagship rule on the starred form *Rin tijonel, then opens with a dialogue in which the cast says Rin aj Tz'olöj Ya', the same construction minus the required marker, four times, without comment. Chapter 6 states the wi fronting rule categorically and then breaks it in its own reading; the corpus shows the rule as stated is too strong, so here the dialogues are right and the grammar box is wrong, which is arguably worse. The spelling of common words drifts silently between chapters, k'ayib'äl and k'ayb'äl, wakamin and wakami, matyox and matyöx, manq'uq' and manq'u'q, in a book that elsewhere flags every variant it touches. The family saga even loses track of its own genealogy: the grandmother who does not exist in Chapter 5 receives a visit in Chapter 14, and a newborn in Chapter 25 is given the name of the book's adult heroine. None of this is fatal. All of it is exactly what a systematic consistency pass, of the kind the author has already automated for attestation, would catch.

the-teaching

What of the book as a course, rather than as a database of forms? Here the news is mostly, and sometimes exceptionally, good. The methods chapter promises retrieval warm-ups, generation-before-explanation boxes, faded worked examples, recycling exercises and answer keys that explain why, and unlike most books that gesture at the learning-science literature, this one actually implements all of it, chapter after chapter. Several set pieces deserve to be named: the "danger zone" drill on the treacherous xki- prefix cluster, which isolates a real segmentation ambiguity no competing textbook flags; the change-versus-state treatment of positionals; the recipient trap of yinaya'; the seven-move decoder of Chapter 26, which turns three hundred pages of grammar into a procedure for reading a colonial text, and whose every worked row checks out. The framing of relational nouns as ordinary possessed nouns, so that one rule from Chapter 5 unlocks the whole system, is the kind of structural insight that justifies the book's subtitle.

The failures of the teaching are failures of appetite. Chapter 24 carries roughly two hundred vocabulary entries against the brief's own ceiling of sixty; Chapter 19 imports a dozen context-free shape adjectives that never recur; Chapter 11 asks fifty-five verbs of a learner in one sitting. Chapter 25 silently abandons the whole pedagogical apparatus, no warm-up, no recycling, no why-notes, as though a different, more tired author wrote it. Chapter 3 demands morphological parsing four chapters before the morphology is taught. And several chapters assert statistics, "well over half the verbs you meet are transitive", that nothing in the corpus is cited to support, a small vice in most books but a live contradiction in this one, whose entire personality is the receipt.

The second edition, then, has a clear docket. Fix the catalogued errors; they are few, findable, and listed below. Run the consistency pass and pick citation forms once. Restore the honesty flags, and mark extrapolation as extrapolation, which costs one typographical convention and buys back the book's whole epistemic warrant. Rewrite or attribute the borrowed sentences; the corpus is large enough now that original examples are cheap. Renovate Chapter 25 to the standard of its siblings, and split the market chapter's vocabulary into a taught core and a browsable pantry. None of this is structural. The structure is sound.

It is a rare thing to review a grammar and find that its most damning witness is a script the author wrote himself. It is rarer still to find that, on the whole, the defendant passes.

A closing word about what the book is for. Kaqchikel has perhaps half a million speakers and a written record older than most European vernacular grammars, and the learner materials available in English remain scarce, uneven, and mostly out of print. A self-study course that is free, checkable, and honest about its own limits is a real contribution to that small shelf, and the habit it most needs to deepen, saying only what the evidence supports and saying so out loud, is the habit it was founded on. The first edition promised a book built from the ground up. The ground, it turns out, is solid. The second edition's work is in the mortar.

~ $ cat errata.log

The concrete findings behind the essay, for the second edition. Paths cite the chapter source files; evidence cites the corpora in raw/ by file and line. Only findings verified against a quotable source are listed.

objective-errors

textbook/01-sounds-and-spelling.md:245 [error]

xoq'a lacks its final glottal stop, and the claimed fuller form xokoq'a is the glossary's word for "rainbow" (utz_awach.txt:10268). Attested: xoq'a', xok aq'a' (utz_awach.txt:10910, 886), xokaq'a' (kojtzijon.txt:375).

textbook/01-sounds-and-spelling.md:245, 02-how-sentences-work.md:258 [error]

Variant "yün" for rin is unattested; an OCR artifact of the glossary's yïn. Attested variants: yin, yïn, ri'in (kojtzijon.txt:580; dialect_variation.txt:1496).

textbook/01-sounds-and-spelling.md:410,529,535 [error]

Advertised minimal pairs are not minimal (qab'i'/kib'i'; key claims "the vowel is the same"); Exercise C key models the wrong syllable of ulew. Source offers true pairs: kawän/qawän, k'am/q'am (utz_awach.txt:806-815).

textbook/09-describing.md:73 [error]

In nim raqän "I am tall" has 3s possessor; the chapter's own table gives nim waqän. Source shows matching persons only (utz_awach.txt:2196).

textbook/14-commands-and-wishes.md:565,694 [error]

nuloq'o' (three times) welds the imperative echo vowel onto an incompletive; no corpus attests aspect n- with -V'. Fix: nulöq' or rephrase (Maxwell on -V' as hortative/imperative only, utz_awach.txt:6113-6115).

textbook/14-commands-and-wishes.md:312 [error]

Takolo' kan ri atzyaq: missing ejective; the verb is -k'öl and the book's own table gives tak'olo'. The error reproduces the source's OCR-mangled glossary line (utz_awach.txt:8481 vs. correct 2260-2267).

textbook/15-directionals-and-motion.md:33,309 [error]

xik'o "I passed through" is third person; the chapter's own paradigm requires xinik'o (cf. utz_awach.txt:7138, 3s "xik'o").

textbook/15-directionals-and-motion.md:630 [error]

Key glosses nel el Tz'olöj Ya' as "leaves for Sololá" while the dialogue uses the same string as "left Sololá"; complement of -el is the place exited (utz_awach.txt:5284). "Leaves for" = nb'e + town (5267).

textbook/20-negation-and-irrealis.md:264 [error]

Majun b'ey nutz'eton ri choy glossed "He has never seen the lake"; nu- is 1sA, and the source glosses this very form first person (utz_awach.txt:6916). The book's own answer E9 gets it right.

textbook/25-people-work-body-feelings.md [error]

Cousins reduced to one term nuch'itichaq'; the source gives the full ch'iti- + sibling-term paradigm: ch'iti'ana', ch'itixib'alon, ch'itichaq' (utz_awach.txt:2726, 2749, 2729).

textbook/25-people-work-body-feelings.md:244 [error]

xerka glossed "jacket"; the source: "man's woolen breechcloth" worn over trousers (utz_awach.txt:10234, 2101-2103). "Jacket/sweater" is koton.

textbook/26-reading-kaqchikel.md:341 [error]

niwayjan should be nwayjan by the book's own n-/y- rule (3sB Ø before consonant); as printed it reads as 2p.

textbook/05-possession.md:76,471 [error]

achib'äl "picture" given tensing possessed forms (wachib'al); the source lists it among invariant nouns: rachib'äl (utz_awach.txt:4844; modern choltzij_entries.tsv:1184 ruwachib'äl).

textbook/03-greetings-and-social-talk.md:105 [error]

Ke re' glossed literally "like that"; re' is "this", per the book's own vocabulary and the source (utz_awach.txt:912, 5800).

textbook/19-positionals.md:170 [error]

Glossary label "Col" (Colonial-era) on chupül q'aq' "firefly" misread as "colloquial" (abbreviation key at utz_awach.txt:7318-7327).

textbook/10-numbers-and-time.md:121 [error]

"You will see the stem ka- again in kab'ij": kab'ij contains kab'-, the stem the sentence contrasts against (utz_awach.txt:6693, 6711).

textbook/99-appendices.md:90-114 [error]

Potential forms xtqa-/xtki- printed as primary or sole forms; Chapter 13 stars them as errors and only i-forms are attested (utz_awach.txt:5440, 6877, 9699). Make xtiqa-/xtiki- the table forms.

textbook/99-appendices.md:1497 [error]

ruma/roma geography inverted: ruma is the majority and Tecpán form (dialect_variation.txt:1680-1690); roma is listed only for Xenacoj and San Marcos. Modern corpora nearly categorically ruma.

textbook/99-appendices.md:1511,1518 [error]

ch'ima' attributed to Sololá; the survey places it in San Marcos, Tecpán and San Lucas, and warns it means "vagina" to adults in most variants (dialect_variation.txt:3616-3628). Add the warning; also note ma is derogatory in SAC and San Pedro (2853-2859).

textbook/99-appendices.md:302,651,356,169,588 [error]

ch'on chik k'a drops the glottal of -ch'o'n (utz_awach.txt:11697); "cent" printed ruxik' maq'uq' next to manq'uq', inheriting the source's own typo (9515 vs. 8748); alite'ej unattested for attested alite' (7439); -ch'ok'e' for attested -ch'oke' (10045); plural q'ija' unattested.

charter-violations

textbook/23-connecting-ideas.md:154 [charter]

The source's "Wi najin ta jäb' chwa'q..." is copied with its translation altered from "if it rains" to "if it should rain" to support an undocumented tentativeness claim for ta (utz_awach.txt:7189; parallel counter-example 7191). Remove the doctrine or find real support.

textbook/11-*.md .. 24-*.md [charter]

20+ verbatim or one-word-swapped example lifts logged, e.g. "Xtzaq qa pa b'ey" (utz_awach.txt:9165), the sweater question (4692), "Majun b'ey nutz'eton" with gloss (6916), "Xintz'ët ri wakx..." (6370), the bargaining line (3455), "Tab'ij pe chqe kow" (6734), "Xiloq'on richin nute'" (6072), "Xkik'ül ki' pa b'ey" (4562), Ch. 11's daily-routine text tracking the source's (4046-4064). Rewrite with the cast and new nouns.

textbook/26-reading-kaqchikel.md [charter]

Four anthology quotations plus one Chronicles line against the brief's "one or two per chapter". All five verified accurate and correctly attributed; amend the brief for this chapter or trim.

extrapolation-as-attestation

textbook/10-numbers-and-time.md:106-121,827 [unattested]

Of kawinäqlajwinäq (40–200), corpora attest only juwinäq and kajwinäq (plus kawinäq in Chronicles); the k'al series is fully attested (utz_awach.txt:5521-5536). Mark the rest as regular extrapolations and let the key prefer k'al forms.

textbook/16-states-and-ongoing-actions.md:277,316,329 [unattested]

Tew ninna', K'o k'atän chrij admitted as constructed, then entered as plain vocabulary; jani na "not yet" unattested (attested: majani, utz_awach.txt:8697).

textbook/21-questions.md:144, 22-relational-nouns.md:281 [unattested]

Negative tag ¿la man ke ri' ta? unattested (real tags: peja', qupe, utz_awach.txt:9056, 9194); invented verb nqachaq' qi' "we are siblings" has no license (use öj ach'alal).

textbook/99-appendices.md:187-194 [unattested]

Fused spellings chinuwäch, chiqaxe', chikij... unattested; sources write two words except where phonology fuses (chwij, chuwäch, chuxe') (utz_awach.txt:3662, 5259; chronicles_interlinear.tsv:714). The table also mixes both conventions internally.

textbook/*.md ([?] flags) [unattested]

The uncertainty apparatus has decayed: most surviving flags mark attested forms (wuqq'ij fb_kaqchikel.txt:114; kawinäq chronicles_interlinear.tsv:1152; -chajij passim), while genuinely unattested items (above) carry none. Re-audit every flag.

textbook/02,11,12,15 (sundry) [unattested]

"Younger speakers increasingly front..." (source says only "perhaps under Spanish influence"); "well over half the verbs are transitive"; the aqanäj "rises on its legs" etymology; -q'ab'är derived from q'ab'arel (backwards); "the source attests this order" for two sentences it does not contain (Ch. 15); the comitative plural-verb claim misattributed to the source (Ch. 11).

consistency-drift

textbook/*.md (spelling) [consistency]

Pick citation forms once and note variants once: k'ayib'äl/k'ayb'äl (split by chapter), wakamin/wakami, matyox/matyöx, manq'uq'/manq'u'q (Ch. 7 has the non-canonical one), achib'il/achb'il, jöb'/jäb', chwäch/chuwäch, rochoch/rachoch, chirij/chuxe' as used in Ch. 19 vs. disclaimed in Ch. 22, Iximulew vs. "Ixim Ulew", capitalization of Pa Jotöl.

textbook/05:386, 14:58, 25:472 (cast) [consistency]

Ch. 5: "Majun wati't" (no grandmother); Ch. 14: Ixchel sent to "your grandmother's house". Ch. 25 names a newborn Ixchel in the sister's house. Rename the baby; resolve the grandmother.

textbook/12,14,17,18,24,26 (verb tags) [consistency]

-ajo', -b'ij, -k'waj, -to', -tzu', -ya' tagged "vtd" in vocabularies while the prose calls them root transitives; Ch. 24 vs. Ch. 26 give contradictory rationales for tak'waj. One taxonomy, applied everywhere.

textbook/04,06,17,21,18 (model input) [consistency]

Ch. 4 dialogue drops Set B in aj-predicates against its own starred rule (either fix the dialogue or teach the attested omission, cf. utz_awach.txt:4728); Ch. 6/3 readings break the categorical wi rule, which is itself too strong (teach focus vs. scene-setting, kojtzijon.txt:1065); Ch. 17 dialogue omits wi after akuchi' one chapter after drilling it; Ch. 21's doorway dialogue reverses the ritual its own prose describes (utz_awach.txt:4724-4730); Ch. 18's "no article after antipassive" rule is contradicted by its own Uses 3–5 (distinguish agent-focus from true antipassive, cf. chronicles_interlinear.tsv:2703 vs. 604).

pedagogy

textbook/03,11,19,24,25 (load) [pedagogy]

Ch. 24 ≈200 vocabulary entries and Ch. 25 similar, against the brief's 25–60; Ch. 11 lists ~55 verbs; Ch. 19 imports twelve context-free shape adjectives; Ch. 3 carries 61 rows including 13 toponyms. Split taught core from browsable reference, and let the flashcard app default to core.

textbook/25-people-work-body-feelings.md [pedagogy]

Silently abandons the book's apparatus: no warm-up, no Try-it-first, no recycle exercise, no why-notes, nonstandard exercise headings and dialogue formatting. Renovate first.

textbook/02,03,15,16,23 (sequencing) [pedagogy]

Ch. 3 Exercise C requires imperative morphology taught in Ch. 14 (make it recognition); Ch. 2 Exercise G requires free production of Ch. 11–12 morphology (make it matching or allow copying); Ch. 16's "passive stem" parenthesis lands two chapters early (footnote it); Ch. 15's go-and-do gloss labels a dependent status suffix "IMP" (use a neutral label, cf. chronicles_interlinear.tsv:73); Ch. 23 uses the tag qupe untaught.

textbook/20-negation-and-irrealis.md:349-355 [pedagogy]

The polarity of manta + NP flips between adjacent examples ("if it were me" / "if it weren't for the doctor") with no rule; inherited from the source, but a book that promises "why" owes the learner at least a warning that context decides.

Method: eight independent audit passes over the 28 chapter files (~21,000 lines), every finding verified by direct quotation from the corpora in raw/: the OCR'd ¿La ütz awäch? (lessons, Maxwell's grammar summary, Little's glossary), the Kaqchikel Chronicles interlinear parses, Salazar Tetzagüic's anthology, Patal Majzul's dialect survey, the Lectoescritura and school readers, Kojtzijon, four dictionaries, the corpus frequency table, and the contemporary Facebook file. Findings the sources refuted were discarded; the essay reports only what survived.