From 52310fa657e4a19f9e059156923466e38cbeaf9d Mon Sep 17 00:00:00 2001
From: Nathan Schneider <n@nathanschneider.info>
Date: Wed, 7 May 2025 15:33:05 -0600
Subject: [PATCH] Added context Component

---
 data/components/intake.yaml                   | 14 +++++-
 static/css/main.css                           | 15 ++++++-
 static/js/data/modules.js                     | 45 +++++++++++++++++++
 static/js/data/templates.js                   | 15 +++++++
 .../layouts/_default/builder.html             | 12 ++---
 5 files changed, 92 insertions(+), 9 deletions(-)

diff --git a/data/components/intake.yaml b/data/components/intake.yaml
index 8520a4c..0478420 100644
--- a/data/components/intake.yaml
+++ b/data/components/intake.yaml
@@ -68,4 +68,16 @@
       type: text
       label: "What commitments does participation involve?"
       placeholder: "Describe what participants are committing to when they engage in the process..."
-      required: true
\ No newline at end of file
+      required: true
+
+- id: context
+  title: "What additional context should participants know?"
+  description: "Background information, external knowledge sources, and relevant references"
+  stageId: intake
+  order: 7
+  fields:
+    - id: contextText
+      type: text
+      label: "What additional context should participants know?"
+      placeholder: "Provide additional context such as links to external knowledge sources, background information, or other relevant references..."
+      required: false
\ No newline at end of file
diff --git a/static/css/main.css b/static/css/main.css
index 012a04f..2e84c54 100644
--- a/static/css/main.css
+++ b/static/css/main.css
@@ -1443,12 +1443,18 @@ textarea {
   line-height: 1.6;
   border: 1px solid #ddd;
   border-radius: 4px;
-  padding: 10px;
+  padding: 12px;
   background-color: #f8f8f8;
 }
 
 .markdown-help p {
-  margin: 0.5em 0;
+  margin: 0.7em 0;
+  padding-bottom: 0.5em;
+  border-bottom: 1px dotted #eee;
+}
+
+.markdown-help p:last-child {
+  border-bottom: none;
 }
 
 .markdown-help code {
@@ -1457,4 +1463,9 @@ textarea {
   padding: 2px 4px;
   border-radius: 3px;
   font-size: 0.9em;
+}
+
+.markdown-help a {
+  color: #0066cc;
+  text-decoration: underline;
 }
\ No newline at end of file
diff --git a/static/js/data/modules.js b/static/js/data/modules.js
index 1d190db..daf3176 100644
--- a/static/js/data/modules.js
+++ b/static/js/data/modules.js
@@ -626,6 +626,51 @@ const moduleData = {
   ],
   // Adding intake module options
   intake: [
+    {
+      id: "external-resources-context",
+      title: "External Resources Context",
+      componentId: "context",
+      fieldId: "contextText",
+      content: `Participants in our dispute resolution process should be aware of these external resources:
+
+1. [Community Standards Guide](https://example.com/standards) - Our complete set of community standards and guidelines
+2. [Conflict Resolution Handbook](https://example.com/handbook) - A comprehensive guide to conflict resolution approaches
+3. [Legal Rights Reference](https://example.com/legal-rights) - Information about legal rights and responsibilities
+4. [Communication Resources](https://example.com/communication) - Tools and techniques for effective communication
+5. [Mental Health Support](https://example.com/support) - Resources for mental and emotional wellbeing during conflicts
+
+These resources provide important context and support for the dispute resolution process.`
+    },
+    {
+      id: "community-specific-context",
+      title: "Community-Specific Context",
+      componentId: "context",
+      fieldId: "contextText",
+      content: `Important contextual information for participants:
+
+1. Our community's dispute resolution process was developed collaboratively in 2019 and undergoes annual review.
+2. Historical context about our community can be found in the [Community Archive](https://example.com/archive).
+3. For terminology definitions, reference our [Glossary of Terms](https://example.com/glossary).
+4. Past case examples (with identifying information removed) are available at [Case Studies](https://example.com/cases).
+5. Culturally-specific resources and considerations are documented at [Cultural Guidance](https://example.com/cultural-guidance).
+
+Understanding this context helps participants engage more effectively in the dispute resolution process.`
+    },
+    {
+      id: "educational-context",
+      title: "Educational Resources Context",
+      componentId: "context",
+      fieldId: "contextText",
+      content: `To prepare for participation in the dispute resolution process, we recommend these educational resources:
+
+1. [Introduction to Nonviolent Communication](https://example.com/nvc) - Learn communication techniques that help prevent escalation
+2. [Understanding Conflict Styles](https://example.com/conflict-styles) - Identify your natural approach to conflict
+3. [Implicit Bias Awareness](https://example.com/bias) - Recognize how biases might affect your perspective
+4. [Active Listening Tutorial](https://example.com/listening) - Practice skills for better understanding others
+5. [Emotional Regulation Techniques](https://example.com/emotional-regulation) - Tools for maintaining calm during difficult conversations
+
+These resources provide skills and knowledge that can help make the dispute resolution process more effective.`
+    },
     {
       id: "incident-report-form",
       title: "Incident Report Form",
diff --git a/static/js/data/templates.js b/static/js/data/templates.js
index abaad2f..cc87085 100644
--- a/static/js/data/templates.js
+++ b/static/js/data/templates.js
@@ -27,6 +27,9 @@ const rawProtocolTemplates = [
           },
           participation_commitments: {
             participationCommitmentsText: "Participants in restorative processes commit to: 1) Speaking honestly from their own experience, 2) Listening deeply to others without interruption, 3) Maintaining confidentiality about what is shared, 4) Working toward understanding before solutions, 5) Following through on agreements they make, and 6) Engaging with respect and care for themselves and others throughout the process."
+          },
+          context: {
+            contextText: "Participants in our restorative justice process should be aware of these resources:\n\n1. [Restorative Justice Handbook](https://example.com/rj-handbook) - A comprehensive guide to our approach\n2. [Circle Process Guidelines](https://example.com/circle-guidelines) - Detailed information about how circles work\n3. [Harm and Healing Framework](https://example.com/healing) - Our conceptual approach to addressing harm\n4. [Community Values Statement](https://example.com/values) - The foundational values that guide our community\n5. [Support Resources](https://example.com/support) - Additional resources for emotional support during the process"
           }
         },
         process: {
@@ -141,6 +144,9 @@ const rawProtocolTemplates = [
           },
           participation_commitments: {
             participationCommitmentsText: "Participants commit to: 1) Engaging honestly in examining harm and its impacts, 2) Considering both individual and collective dimensions of accountability, 3) Respecting confidentiality boundaries established by the group, 4) Working to understand systemic factors beyond individual actions, 5) Contributing to implementation of agreements, and 6) Participating in follow-up and ongoing learning."
+          },
+          context: {
+            contextText: "To better understand our transformative justice approach, participants should explore these resources:\n\n1. [Transformative Justice Theory](https://example.com/tj-theory) - The conceptual framework behind our approach\n2. [Systems Analysis Guide](https://example.com/systems-analysis) - How to analyze systemic patterns that contribute to harm\n3. [Community Accountability Practices](https://example.com/accountability) - Examples of community-based accountability processes\n4. [Power Dynamics Resources](https://example.com/power) - Understanding how power operates in communities\n5. [Trauma-Informed Approach](https://example.com/trauma) - Resources on trauma-informed practices in conflict resolution"
           }
         },
         prepare: {
@@ -266,6 +272,9 @@ const rawProtocolTemplates = [
           },
           participation_commitments: {
             participationCommitmentsText: "All participants in the jury process commit to: 1) Providing truthful information and evidence, 2) Adhering to scheduled deadlines and hearing dates, 3) Treating all participants with respect regardless of disagreements, 4) Preparing materials as requested by the jury, 5) Accepting the jury's decision as binding within community governance, and 6) Implementing agreed-upon actions or decisions within specified timeframes."
+          },
+          context: {
+            contextText: "Participants in our community jury process should consult these resources:\n\n1. [Jury Process Handbook](https://example.com/jury-handbook) - Complete guide to our jury procedures\n2. [Evidence Guidelines](https://example.com/evidence) - Information about what constitutes acceptable evidence\n3. [Previous Decisions Database](https://example.com/past-decisions) - Anonymized records of precedent-setting cases\n4. [Community Standards Reference](https://example.com/standards) - Compilation of community rules and agreements\n5. [Procedural Fairness Guide](https://example.com/fairness) - Principles that ensure fair process in community adjudication"
           }
         },
         prepare: {
@@ -397,6 +406,9 @@ const rawProtocolTemplates = [
           },
           participation_commitments: {
             participationCommitmentsText: "Parties in the referee process commit to: 1) Providing accurate and complete information, 2) Responding to referee requests within specified timeframes, 3) Participating in scheduled meetings prepared and on time, 4) Engaging respectfully even during disagreement, 5) Considering resolution options with an open mind, 6) Abiding by the referee's determination, and 7) Implementing required actions within established deadlines. These commitments are acknowledged in writing at the process start."
+          },
+          context: {
+            contextText: "For the referee process, participants should review these important resources:\n\n1. [Referee Procedures Manual](https://example.com/referee-manual) - Comprehensive guide to our process\n2. [Community Policy Handbook](https://example.com/policy) - Compilation of our community policies and agreements\n3. [Decision-Making Framework](https://example.com/decision-framework) - How referees approach decisions\n4. [Case Preparation Guide](https://example.com/preparation) - How to prepare effectively for the process\n5. [Previous Determinations](https://example.com/determinations) - Examples of past referee decisions (anonymized)"
           }
         },
         prepare: {
@@ -525,6 +537,9 @@ const rawProtocolTemplates = [
           },
           participation_commitments: {
             participationCommitmentsText: "Participants commit to: 1) Communicating honestly and respectfully, 2) Listening to understand rather than to respond, 3) Working toward a mutually beneficial resolution, 4) Respecting confidentiality, and 5) Following through on any agreed-upon actions."
+          },
+          context: {
+            contextText: "To support effective peer-to-peer resolution, consider these resources:\n\n1. [Communication Guide](https://example.com/communication) - Effective communication techniques for difficult conversations\n2. [Conflict Resolution Basics](https://example.com/basics) - Fundamental concepts for resolving disputes\n3. [Active Listening Tutorial](https://example.com/listening) - How to listen effectively during conflict\n4. [Interest-Based Negotiation](https://example.com/negotiation) - Finding solutions that address underlying interests\n5. [Agreement Writing Templates](https://example.com/agreements) - Templates for documenting your resolutions"
           }
         },
         process: {
diff --git a/themes/dispute-protocol-theme/layouts/_default/builder.html b/themes/dispute-protocol-theme/layouts/_default/builder.html
index 11e824d..082fa7d 100644
--- a/themes/dispute-protocol-theme/layouts/_default/builder.html
+++ b/themes/dispute-protocol-theme/layouts/_default/builder.html
@@ -124,12 +124,12 @@
       <div class="sidebar-section">
         <h3>Markdown Help</h3>
         <div class="sidebar-info markdown-help">
-          <p><strong>Bold text:</strong> **bold** or __bold__</p>
-          <p><em>Italic text:</em> *italic* or _italic_</p>
-          <p><strong>Links:</strong> [text](url)</p>
-          <p><strong>Lists:</strong> Start lines with - or 1.</p>
-          <p><strong>Headings:</strong> # Heading or ## Subheading</p>
-          <p><strong>Quotes:</strong> > Your quoted text</p>
+          <p><strong>Bold:</strong> **bold text** → <strong>bold text</strong></p>
+          <p><strong>Italic:</strong> *italic text* → <em>italic text</em></p>
+          <p><strong>Links:</strong> [link text](https://example.com) → <a href="#">link text</a></p>
+          <p><strong>Lists:</strong><br>- Item 1<br>- Item 2<br>Or<br>1. First item<br>2. Second item</p>
+          <p><strong>Headings:</strong><br># Main Heading<br>## Subheading</p>
+          <p><strong>Quotes:</strong><br>> Your quoted text<br>> Another line</p>
         </div>
       </div>
     </div>