HSKMAP
HSKMAP Editorial Methodology
See how HSKMAP handles vocabulary sources, meanings, examples, translations, audio, automated checks, corrections, and learning-content limitations.
Why this methodology is public
A vocabulary tool should make it possible to understand where its material comes from and how mistakes are corrected. HSKMAP publishes this methodology so learners can distinguish imported source data, project-authored explanations, translations, generated media, and study advice.
The site does not treat build automation as editorial review. Scripts help detect missing fields, invalid routes, inconsistent vocabulary counts, and broken metadata, but they cannot decide whether every definition, example, or pronunciation is the best explanation for every learner.
Vocabulary scope and source separation
The public map is organized around the familiar classic HSK 1-6 structure: 150 words at HSK 1, 150 additional words at HSK 2, 300 at HSK 3, 600 at HSK 4, 1,300 at HSK 5, and 2,500 at HSK 6. The level pages preserve that structure instead of silently mixing it with newer standards.
Newer HSK 3.0 source work is maintained separately while it is incomplete. Experimental imports, missing meanings, and unfinished reading material are not presented as a completed public exam syllabus. Current exam candidates should always confirm the syllabus and registration rules with an official testing source.
Meanings and example sentences
English meanings are short study labels, not claims that a Chinese word has one exact English equivalent. Where a word has several useful senses, the data can preserve multiple meanings or notes. Example sentences are used to show word order and a plausible context rather than to replace a grammar reference.
The repository separates vocabulary records, localized meanings, and sentence data so corrections can be reviewed without rewriting an unrelated page. Project-authored and reused material is tracked in the data pipeline, and learner reports are used to find meanings that are too broad, examples that sound unnatural, or pinyin that needs correction.
Translations and audio
Localized meanings and example translations are stored by language and level. Automated validation checks coverage and data shape, while corrections are made when a translation is misleading or fails to match the Chinese example. English resource guides are not automatically copied into localized map pages when no reviewed translation exists.
Word audio is a pronunciation aid attached to vocabulary records. File-generation and coverage checks can confirm that an asset exists, but audio should still be treated as one study reference. Learners working on precise pronunciation should compare several speakers and seek feedback from a teacher or proficient speaker.
Quality checks before publication
The production build checks that public routes have one clear heading, unique titles, descriptions, canonical URLs, index directives, structured data where appropriate, and sitemap entries. Vocabulary pages are generated as readable HTML so the learning content is available without depending on a blank application shell.
Automated checks also protect boundaries that matter to learners and crawlers: missing routes must return a real 404 response, internal preview routes are not public production pages, and advertising code is not loaded on navigation, legal, contact, error, or unfinished screens.
Corrections and change history
Corrections should identify the level, Chinese word, current pinyin or meaning, and the proposed change. Technical reports should include the route, device or browser, and steps that reproduce the problem. Public reports must not include private information.
The repository preserves a visible change history. A correction may affect a data record, translation module, generated audio asset, study guide, or verification rule depending on the source of the problem.
Related HSKMAP resources
Keep studying with the map
Study resources
A starting point for the HSKMAP guides, plans, pronunciation notes, and map workflow.
HSK study guide
Plan vocabulary review with pinyin, tones, examples, flashcards, writing, and weekly checks.
HSK level check
Use graded recognition, reading, and recall tasks to choose a practical map starting point.
HSK 1 plan
A beginner-friendly four week plan for first words, tones, and simple sentences.
HSK 2 plan
A six week plan for stronger beginner vocabulary, grammar frames, and recall.
Classic HSK guide
How classic HSK 1-6 vocabulary levels build from foundation words to advanced reading.
Pinyin and tones
Pronunciation habits for initials, finals, tones, and character-based review.
How to use HSKMAP
Use maps, word cards, progress labels, flashcards, audio, and writing practice together.
Open the vocabulary map
Review all classic HSK 1-6 levels with word cards, audio, examples, and progress labels.