pediatric-ai-scribe-v3/docs
Daniel 154b896d5b
Some checks failed
Forgejo Docker Build / Build Docker image (push) Blocked by required conditions
Forgejo Docker Build / Deploy to the host (push) Blocked by required conditions
Forgejo Android APK / Root app tests (push) Successful in 58s
Forgejo Docker Build / Root app tests (push) Successful in 49s
Forgejo Android APK / Build signed APK (push) Has been cancelled
feat: Word is built by python-docx from the same typed source as the deck
Pandoc reads markdown, so every Word export had to flatten the resource to
markdown first — and a deck flattened to markdown stops being one. A comparison
became two headings and two lists, a callout became bold text, and a figure
became nothing at all, because markdown has nowhere to put it.

src/utils/docSpec.js reduces either source to the same blocks: a stored deck
where there is one, the markdown where there is not. scripts/render_docx.py
draws them. A comparison comes out as a labelled two-column table, a callout as
a shaded box, a table as a real table, a figure embedded at its own aspect ratio
with its caption, and speaker notes as muted indented text.

The deck wins over the markdown beside it, because that markdown is a
serialisation of the deck and reading it instead would be reading a lossy copy of
what is right there.

Word now carries the figures too. The export route skipped fetching them for
docx, which was correct when pandoc could not place them and wrong the moment
this could.

Pandoc stays installed and stays the fallback: a plainer document beats a failed
download. Both renderers now share one spawn helper.

Verified end to end: a deck with two figures exported as a six-page Word document
with both images embedded (537KB, two files in word/media), rendered to PDF and
looked at — the comparison is a labelled table, the figure sits at its true
aspect ratio, and the notes read as notes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Dv6sqaY6Vq3ChZHMem3cnU
2026-09-11 21:58:53 +02:00
..
logic simplify speech and embeddings through litellm 2026-05-09 05:09:02 +02:00
ai-providers.md docs refresh current workflows 2026-05-09 00:40:45 +02:00
api-reference.md docs: recording, 24-hour retention, and the STT picker 2026-09-10 16:44:17 +02:00
ARCHITECTURE.md document architecture and harden rendering 2026-05-10 01:07:56 +02:00
architecture.md ci: route Android APK through Forgejo releases 2026-05-11 04:21:15 +02:00
authentication.md docs: My Resources, sign-in codes, invitations, and what the image carries 2026-09-11 20:49:10 +02:00
CLINICAL_ASSISTANT.md feat: My Resources has a menu, a library and three downloads 2026-09-11 15:00:19 +02:00
configuration.md docs: My Resources, sign-in codes, invitations, and what the image carries 2026-09-11 20:49:10 +02:00
database.md docs align memory and audio backup behavior 2026-05-08 23:32:39 +02:00
deployment.md feat: Word is built by python-docx from the same typed source as the deck 2026-09-11 21:58:53 +02:00
developer-guide.md feat: ship reviewed prompt history, conversation limits and account protections 2026-09-07 04:01:01 +02:00
DEVELOPMENT.md feat: ship reviewed prompt history, conversation limits and account protections 2026-09-07 04:01:01 +02:00
embeddings-setup.md simplify speech and embeddings through litellm 2026-05-09 05:09:02 +02:00
features-explained.md simplify speech and embeddings through litellm 2026-05-09 05:09:02 +02:00
global-prompt-administration.md fix: reviewer findings — mhchem macro wrapping, regenerate history dedupe, strict safe image allowlist, stale docs 2026-09-08 19:25:31 +02:00
improvements.md docs refresh current workflows 2026-05-09 00:40:45 +02:00
learning-hub.md feat: My Resources has a menu, a library and three downloads 2026-09-11 15:00:19 +02:00
migrations.md docs: rewrite architecture, authentication, configuration, deployment, ai-providers, speech, database, learning-hub, migrations, developer-guide for public audience 2026-04-15 00:26:38 +02:00
mobile-build.md ci: route Android APK through Forgejo releases 2026-05-11 04:21:15 +02:00
MODULE_CONVENTIONS.md document architecture and harden rendering 2026-05-10 01:07:56 +02:00
my-resources.md feat: Word is built by python-docx from the same typed source as the deck 2026-09-11 21:58:53 +02:00
openid-setup.md feat: ED multi-stage UX, extensions polish, docs viewer + application-logic docs 2026-04-28 03:09:38 +02:00
ops-docs-ped-ai-and-milvus.md docs: Ops Docs page on how Ped-AI and the two Milvus servers work 2026-09-10 18:37:41 +02:00
retrieval-tuning.md docs: My Resources, sign-in codes, invitations, and what the image carries 2026-09-11 20:49:10 +02:00
SCALING.md document architecture and harden rendering 2026-05-10 01:07:56 +02:00
speech.md refactor: one place decides which bucket, on which S3, with which credentials 2026-09-10 17:09:13 +02:00
transcription-options.md docs: recording, 24-hour retention, and the STT picker 2026-09-10 16:44:17 +02:00