Merge pull request #1 from Helen-con/codex/create-digital-sdq-assessm…

README.md

@@ -3,6 +3,8 @@
 This project provides a browser-based version of the Strengths and Difficulties Questionnaire (SDQ).
 It guides the assessor through each of the 25 SDQ items one at a time, calculates subscale and total
 difficulties scores, and generates an interpretation with an option to export the results as a PDF.
+The app now supports all three SDQ informant versions: parent/carer, teacher, and self-report for
+young people aged 11–17.
 
 ## Features
 
@@ -11,13 +13,15 @@ difficulties scores, and generates an interpretation with an option to export th
 - Narrative interpretation highlighting areas that fall outside the normal band
 - Exportable PDF report summarising scores and findings
 - Ability to restart the assessment and capture a fresh set of responses
+- Built-in scoring bands for parent/carer, teacher, and self-report questionnaires
 
 ## Getting started
 
 1. Open `index.html` in a modern web browser.
-2. Answer each question sequentially. The **Generate Results** button appears on the final item.
-3. Review the calculated scores and findings.
-4. Optionally export the summary as a PDF or start again to capture new responses.
+2. Enter optional metadata (identifier, date) and choose the SDQ questionnaire version.
+3. Answer each question sequentially. The **Generate Results** button appears on the final item.
+4. Review the calculated scores and findings tailored to the selected informant version.
+5. Optionally export the summary as a PDF or start again to capture new responses.
 
 > **Note:** Scoring bands reflect the UK SDQ guidance for ages 4–17. The digital tool supports
 screening and discussion but does not replace clinical judgement.

index.html

@@ -15,15 +15,30 @@
     <header class="app__header">
       <h1>Strengths and Difficulties Questionnaire (SDQ)</h1>
       <p class="app__intro">
-        Complete each question in sequence. Select the response that best describes the child's behaviour over the past six months. 
-        Results include subscale scores, total difficulties, and interpretation guidance.
+        Complete each question in sequence. Select the response that best describes behaviour over the past six
+        months. Choose the appropriate questionnaire version for parents and carers, teachers, or self-reporting
+        young people (ages 11–17).
       </p>
     </header>
 
-    <!-- Identifier + Date -->
-    <div class="metadata" style="margin:1rem 0; padding:1rem; border:1px solid #ddd; border-radius:8px;">
-      <label for="identifier"><strong>Identifier / Name:</strong></label>
-      <input type="text" id="identifier" name="identifier" placeholder="Enter ID or name" style="margin:0 1rem 0 .5rem">
+    <section class="metadata" aria-label="Assessment details">
+      <div class="metadata__field">
+        <label for="identifier">Identifier / Name</label>
+        <input type="text" id="identifier" name="identifier" placeholder="Enter ID or name">
+      </div>
+      <div class="metadata__field">
+        <label for="date">Date</label>
+        <input type="date" id="date" name="date">
+      </div>
+      <div class="metadata__field metadata__field--full">
+        <label for="questionnaireType">Questionnaire Version</label>
+        <select id="questionnaireType" name="questionnaireType">
+          <option value="parent">Parent / Carer Report</option>
+          <option value="teacher">Teacher Report</option>
+          <option value="self">Self-Report (ages 11–17)</option>
+        </select>
+      </div>
+    </section>
 
       <label for="date"><strong>Date:</strong></label>
       <input type="date" id="date" name="date">
@@ -62,6 +77,7 @@ <h2 id="questionText">Question text</h2>
     <!-- Results -->
     <section class="results" id="resultsSection" hidden>
       <h2>Results &amp; Interpretation</h2>
+      <dl class="results__details" id="resultsDetails"></dl>
       <p class="results__summary" id="resultsSummary"></p>
 
       <div class="results__grid" id="resultsGrid"></div>