Doc on Questionnaire Template

[john-d03]

/document Definitions & Terminology/Questionnaire Template

[github-actions]

✅ Ezhuthachan completed successfully!

[github-actions]

Ezhuthachan

I could not start writing, because there is no resource named "Questionnaire Template" in Care. Three different things in the source could be meant, and two of them already have pages. I need one answer before I write anything.

Questions

1. Which of these three do you mean?

#	Thing in the code	What the user sees	Docs today
A	QuestionnaireResponseTemplate (care/emr/models/questionnaire.py:145, resources/questionnaire_response_template/spec.py)	"Response Templates" — a saved bundle of pre-filled answers, draft medication requests, and activity definitions	Concept and reference exist: definitions/questionnaire-response-template.mdx
B	TemplateConfig on a question (resources/questionnaire/spec.py:108, used by Question.templates at line 151)	"Insert Template" — reusable text snippets a clinician drops into a text answer (QuestionTypes/TemplateSelector.tsx)	Only two table rows inside references/definitions/questionnaire.mdx
C	Template for reports (care/emr/models/report/template.py, resources/report/template/spec.py)	Facility "Templates" page and builder, at /facility/:facilityId/template	Reference only: references/platform/report.mdx. No concept page

2. If you mean A, do you want the two existing pages rewritten to the current template? They predate the current standard, so bringing them up to it means replacing the files rather than patching them. Say yes and I will do that; say no and I will leave them alone.

3. If you mean C, may I move it out of Definitions & Terminology? A report template is not a reusable clinical definition. It belongs in platform, next to the report reference it is already documented in. Putting it under definitions would split one primitive across two domains.

4. Which doc types do you want? Your command omitted them, which normally means all three — concept, flow, and reference. For A and C I can write flows from the frontend. For B there is no standalone user task, so a flow would have nothing to describe.

Reply with, for example, A, rewrite, concept+reference and I will run again.

Bugs and inconsistencies

None that I am confident about. I only read the questionnaire, response-template, and report-template models, their specs, and the matching frontend components, which is not enough to call anything broken.

Generated by Ezhuthachan for #66 · opus50 · 123 AIC · ⌖ 9.71 AIC · ⊞ 14.4K · ◷
_{Comment /document to run again}

[github-actions]

Comment Memory

# Issue #66 — "/document Definitions & Terminology/Questionnaire Template"

Status: **blocked on disambiguation** (questions posted, no files changed).

## What was established

There is no Care resource named "Questionnaire Template". Three distinct things
in the source could match, and two of them are already documented:

1. `QuestionnaireResponseTemplate` — `code/care/care/emr/models/questionnaire.py:145`,
   spec `care/emr/resources/questionnaire_response_template/spec.py`, API route
   `questionnaire_response_template` (`config/api_router.py:155`). UI: "Response
   Templates" (`public/locale/en.json` key `response_templates`), managed in
   `src/components/Questionnaire/ManageResponseTemplatesSheet.tsx`.
   **Already documented**: `concepts/definitions/questionnaire-response-template.mdx`
   and `references/definitions/questionnaire-response-template.mdx`.

2. `TemplateConfig` on a question — `care/emr/resources/questionnaire/spec.py:108`
   (`name`, `content`, `structured_content`, `meta`), attached via
   `Question.templates` (line 151). UI: "Insert Template" snippet picker for text
   questions, `src/components/Questionnaire/QuestionTypes/TemplateSelector.tsx`,
   used from `TextQuestion.tsx` (`enter_response_type_slash_for_templates`).
   **Undocumented as its own page**; only a table row in
   `references/definitions/questionnaire.mdx:198,214`.

3. `Template` (report template) — `care/emr/models/report/template.py`,
   spec `care/emr/resources/report/template/spec.py`, statuses draft/active/retired,
   formats pdf/html. UI: facility Templates page + builder,
   `src/pages/Encounters/TemplateBuilder/`, routes `/facility/:facilityId/template*`.
   **Already documented (reference only)**: `references/platform/report.mdx`
   ("Report & Templates"). No concept page exists for it.

Also note: the request wrote the domain as the sidebar label
"Definitions & Terminology"; the folder slug is `definitions`
(`versioned_docs/version-3.0/{concepts,references}/definitions/`).

## Next run

If the answer names candidate 1, the work is a rewrite of the two existing
`questionnaire-response-template` pages to the current templates, plus flows.
If candidate 2, it belongs inside the questionnaire pages or a new
`definitions/question-template`-style page. If candidate 3, the domain is
`platform`, not `definitions`, and a concept page is missing.

Versions: author in `version-3.0`, mirror to `version-3.1`. Flows need a manual
sidebar entry in `versioned_sidebars/`.

Note

This comment is managed by comment memory.

It stores persistent context for this thread in the code block at the top of this comment.
Edit only the text inside the backtick fences; workflow metadata and the footer are regenerated automatically.

Learn more about comment memory

Generated by Ezhuthachan for #66 · opus50 · 123 AIC · ⌖ 9.71 AIC · ⊞ 14.4K · ◷
_{Comment /document to run again}