Skip to content
thuyhuongctuPublic

About

ComDraft is a complete teaching package for a three-credit undergraduate course in business communication and document drafting, taught face to face. Every slide, figure, question, script and video in this repository was authored by the lecturer named above for the classes she teaches in person. Nothing here is derived from a colleague's material.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

ComDraft

Teaching materials for Communication and Document Drafting Skills (EC1103) Bộ học liệu giảng dạy trực tiếp · Học phần Kỹ năng giao tiếp và soạn thảo văn bản

DOI Live app course credits license

ComDraft revision app: home screen

Author: Do Thuy Huong (Đỗ Thùy Hương) · ORCID 0000-0002-7711-2487 PhD Candidate, School of Economics, Can Tho University.

Every slide, figure, question, script and video in this repository was authored by the lecturer named above for the classes she teaches in person. Nothing here is derived from a colleague's material.

Watch the course introduction

▶ Course introduction (~72 s, ~5.6 MB). The home screen plays this same file. The Vietnamese counterpart, assets/video/gioi-thieu.mp4, covers a different topic: the 55-38-7 communication rule.


Contents


The revision app

The repository root is also a small offline-first web app for students, ComDraft, published from this repository via GitHub Pages. It serves the whole 200-question bank with the explanation for every question, and needs no account, no server and no network once it has been opened for the first time.

🎬 Intro on open A 10-second video behind a cover image and a play button. It is not downloaded until a visitor presses play, so opening the app costs no extra data unless they choose to watch it
✅ Practice mode Marks each answer immediately and shows why it is right or wrong
⏱️ Test mode Withholds the marking until the end, for a timed-exam feel
📚 Flexible sets Pick a single chapter or mix all five, choose 10 / 20 / 40 / all questions, filter by cognitive level (recall, comprehension, application)
🔀 Shuffled Questions and options are shuffled, so a second attempt is not the same paper
📊 Breakdown The result screen splits the score by cognitive level and reprints every missed question with its explanation. One button re-runs just those
⭐ Star & drill Students can star hard questions and drill only those later
🔒 Private by design Progress and best scores live in the browser's own storage. Nothing leaves the device, so no student data is collected
📱 Installable, offline Add to a phone's home screen; works fully offline once opened
🔄 One-tap refresh A toolbar button clears the offline cache and reloads, so a student on a stale cached version can pull the newest one on demand

Built as plain HTML, CSS and JavaScript, with no framework and no build step. The question data uses the same registerBank(...) format as the author's earlier EnQuiz app, so a chapter can be edited and reloaded without touching the code.

What this repository holds

A complete, ready-to-teach package for a 3-credit undergraduate course (2 credits of theory, 1 credit of computer-lab practice), built for the 261b cohort, first semester of the 2026–2027 academic year.

Folder Contents
slides/ Five lecture decks, one per chapter (18 to 21 slides each), every slide carrying a speaker-note script for PowerPoint Presenter View. slides-en/ and practice-en/ hold English translations of all eight decks, generated from these Vietnamese originals. Note: the revision app's own chapter viewer (above) no longer shows these five decks; it shows separate, shorter material the lecturer chose to display there instead. These .pptx files remain the source for anyone who wants the full speaker-noted decks
practice/ Three computer-lab workbooks: document formality, administrative documents, commercial documents
quiz/ A 200-question bank (40 per chapter) in two Word editions (with answers for the lecturer, question-only for students), plus the same bank as JavaScript data ready for a quiz app
videos/ Eight Full-HD videos: five chapter revision videos and three lab walkthroughs, with the narration script in JSON. Note: the five chapter revision videos were made for the old chapter decks (see the slides/ note above) and are temporarily hidden from the app's chapter pages until they're rebuilt to match the new content; the three lab walkthroughs are unaffected and still shown
figures/ Eight author-drawn diagrams rendered from code, plus the course persona artwork
scripts/ The generators that produce everything above: decks, figures, question bank, videos

The five chapters

  1. An overview of business communication: the four pillars of business communication, the five-step model and noise, verbal and non-verbal channels (the 7-38-55 rule), forms of communication, diagnosing noise through a real scenario
  2. Professional communication skills: first impressions and the 4×20 rule, business etiquette, presenting, listening and questioning, telephone skills
  3. Communication in specific settings: internal communication, customers and the LAST complaint procedure, partners, state agencies and press, banquet etiquette, cross-cultural work
  4. Business negotiation: nature and styles of negotiation, the five-stage process, BATNA and ZOPA, negotiation skills, recognising common tactics
  5. Drafting and formatting documents: document types, the nine formality components of Decree 30/2020/NĐ-CP, five administrative documents, commercial documents

The three lab sessions

Each workbook carries a five-step teaching rhythm (demonstrate → follow along → work alone → peer-review → submit and revise), the exact Word menu paths for each formatting step, a list of the mistakes students actually make, an eight-point self-check list, the assignment and the marking scheme.

A single business case (a company buying twenty computers) runs from the Chapter 4 negotiation role-play through the Chapter 5 document chain into both lab assignments, so students see one continuous professional workflow rather than disconnected exercises.


How the materials were built

Everything is generated from source, so the whole package can be rebuilt after any edit.

Build pipeline (click to expand)
node scripts/build_decks.js          # chapters 1–4
node scripts/build_ch5_practice.js   # chapter 5 and the three lab workbooks
python3 scripts/make_figs.py         # the eight diagrams
python3 scripts/add_images.py        # place figures and persona artwork
python3 scripts/apply_upgrade.py     # speaker notes, section dividers, stat slides
node  scripts/build_bank_docx.js     # the question bank, both editions
python3 scripts/build_videos.py      # the eight videos

Decks are produced with PptxGenJS; figures are rendered from hand-written HTML and CSS through headless Chromium; the question bank is written with docx; videos combine the rendered slides with Vietnamese speech from Piper and are assembled with FFmpeg. The visual identity (colour, typography, layout grammar) is the author's own and is documented in scripts/design.js.


Using these materials

Free to use for personal study and for teaching the students of this course. Any other use (republishing the slides or the question bank elsewhere, uploading the videos to a channel that is not the author's, reusing the material under another lecturer's or an institution's name, commercial use, or derivative works) requires the author's written permission.

When you use anything from this repository, cite it. See CITATION.cff, or:

Do, T. H. (2026). ComDraft: teaching materials for Communication and Document Drafting Skills (EC1103) (Version 1.0) [Data set]. Zenodo. https://doi.org/10.5281/zenodo.22003676

The DOI above is the concept DOI: it always resolves to the newest release. To cite this exact release instead, use 10.5281/zenodo.22003677.


Related work by the same author

Project rules

The constraints that must hold whenever this repository is edited (no student data collection, only material authored by the lecturer herself, keep the author's mark, and what must be checked before calling a change done) are written down in CLAUDE.md (in Vietnamese, the language of the course). Anyone editing here should read that page first.

Automated tests

The repository ships a test suite that runs against a real browser:

pip install playwright && python -m playwright install chromium
python3 tests/kiem_tra.py

Twenty-six checks, covering: the Vietnamese–English vocabulary keys match, subtitles match the narration script verbatim, the slide image counts match what's declared, the slide and video viewers, the enrolment gate (including that it only accepts a school-looking email and closes the two paths that used to bypass it), the formality practice exercise, badges and the completion certificate, the Huong AI tour, layout on a phone-width screen, and four project-wide constraints: no request ever leaves the page, no JavaScript errors, the footer keeps the author's name and DOI, and the certificate never claims to be an official credential.

The same suite also runs automatically on GitHub on every push (.github/workflows/kiem-tra.yml).


© 2026 Do Thuy Huong. All rights reserved. See LICENSE.

About

ComDraft is a complete teaching package for a three-credit undergraduate course in business communication and document drafting, taught face to face. Every slide, figure, question, script and video in this repository was authored by the lecturer named above for the classes she teaches in person. Nothing here is derived from a colleague's material.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages