Changes for page Requirements

Last modified by Robert Schaub on 2025/12/24 21:46

From 2.1 to 1.1 From 6.1 to 5.1

From version 5.1

edited by Robert Schaub
on 2025/12/19 10:23

Change comment: There is no comment for this version

To version 2.1

edited by Robert Schaub
on 2025/12/19 09:13

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -6,7 +6,7 @@
  == Navigation ==
--* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - What users need from FactHarbor (drives these requirements)
++* **[[User Needs>>FactHarbor.Specification.Requirements.User-Needs]]** - What users need from FactHarbor (drives these requirements)
  * **This page** - How we fulfill those needs through system design
  (% class="box infomessage" %)
@@ -13,7 +13,7 @@
  (((
  **How to read this page:**
--1. **User Needs drive Requirements**: See [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] for what users need
++1. **User Needs drive Requirements**: See [[User Needs>>FactHarbor.Specification.Requirements.User-Needs]] for what users need
 . **Requirements define implementation**: This page shows how we fulfill those needs
 . **Functional Requirements (FR)**: Specific features and capabilities
 . **Non-Functional Requirements (NFR)**: Quality attributes (performance, security, etc.)
@@ -42,7 +42,7 @@
  * Modify content
  * Access edit history details
--**User Needs served**: UN-1 (Trust assessment), UN-2 (Claim verification), UN-3 (Article summary with FactHarbor analysis summary), UN-4 (Social media fact-checking), UN-5 (Source tracing), UN-7 (Evidence transparency), UN-8 (Understanding disagreement), UN-12 (Submit claims), UN-17 (In-article highlighting)
++**User Needs served**: UN-1 (Trust assessment), UN-2 (Claim verification), UN-3 (Summary + verdict), UN-4 (Social media fact-checking), UN-5 (Source tracing), UN-7 (Evidence transparency), UN-8 (Understanding disagreement), UN-12 (Submit claims)
  === 1.2 Contributor ===
@@ -392,7 +392,7 @@
  ==== FR4 — Scenario Generation ====
--**Fulfills**: UN-2 (Context-dependent verification), UN-3 (Article summary with FactHarbor analysis summary), UN-8 (Understanding disagreement)
++**Fulfills**: UN-2 (Context-dependent verification), UN-3 (Summary with scenarios), UN-8 (Understanding disagreement)
  **Automated scenario creation**:
  * AKEL analyzes claim and generates likely scenarios (use-cases and contexts)
@@ -413,7 +413,7 @@
  ==== FR6 — Scenario Comparison ====
--**Fulfills**: UN-3 (Article summary with FactHarbor analysis summary), UN-8 (Understanding disagreement)
++**Fulfills**: UN-3 (Summary with verdicts), UN-8 (Understanding disagreement)
  * Side-by-side comparison interface
  * Highlight key differences between scenarios
@@ -424,7 +424,7 @@
  ==== FR7 — Automated Verdicts ====
--**Fulfills**: UN-1 (Trust score), UN-2 (Verification verdicts), UN-3 (Article summary with FactHarbor analysis summary), UN-13 (Cite verdicts)
++**Fulfills**: UN-1 (Trust score), UN-2 (Verification verdicts), UN-3 (Verdict summaries), UN-13 (Cite verdicts)
  * AKEL generates verdict based on evidence within each scenario
  * **Likelihood range** displayed (e.g., "0.70-0.85 (likely true)") - NOT binary true/false
@@ -446,190 +446,8 @@
  * Confidence score trends visible
  * Users can see "as of date X, what did we know?"
--=== 8.4 User Interface & Presentation ===
++=== 8.4 Workflow & Moderation ===
--==== FR12 — Two-Panel Summary View (Article Summary with FactHarbor Analysis Summary) ====
--
--**Fulfills**: UN-3 (Article Summary with FactHarbor Analysis Summary)
--
--**Purpose**: Provide side-by-side comparison of what a document claims vs. FactHarbor's complete analysis of its credibility
--
--**Left Panel: Article Summary**:
--* Document title, source, and claimed credibility
--* "The Big Picture" - main thesis or position change
--* "Key Findings" - structured summary of document's main claims
--* "Reasoning" - document's explanation for positions
--* "Conclusion" - document's bottom line
--
--**Right Panel: FactHarbor Analysis Summary**:
--* FactHarbor's independent source credibility assessment
--* Claim-by-claim verdicts with confidence scores
--* Methodology assessment (strengths, limitations)
--* Overall verdict on document quality
--* Analysis ID for reference
--
--**Design Principles**:
--* No scrolling required - both panels visible simultaneously
--* Visual distinction between "what they say" and "FactHarbor's analysis"
--* Color coding for verdicts (supported, uncertain, refuted)
--* Confidence percentages clearly visible
--* Mobile responsive (panels stack vertically on small screens)
--
--**Implementation Notes**:
--* Generated automatically by AKEL for every analyzed document
--* Updates when verdict evolves (maintains version history)
--* Exportable as standalone summary report
--* Shareable via permanent URL
--
--==== FR13 — In-Article Claim Highlighting ====
--
--**Fulfills**: UN-17 (In-article claim highlighting)
--
--**Purpose**: Enable readers to quickly assess claim credibility while reading by visually highlighting factual claims with color-coded indicators
--
--==== Visual Example: Article with Highlighted Claims ====
--
--{{code language="none"}}
--┌─────────────────────────────────────────────────────────────────────────────┐
--│ Article: "New Study Shows Benefits of Mediterranean Diet"                  │
--├─────────────────────────────────────────────────────────────────────────────┤
--│                                                                             │
--│ A recent study published in the Journal of Nutrition has revealed new      │
--│ findings about the Mediterranean diet.                                     │
--│                                                                             │
--│ [🟢 Researchers found that Mediterranean diet followers had a 25% lower  │
--│     risk of heart disease compared to control groups]                      │
--│     ↑ WELL SUPPORTED • 87% confidence                                      │
--│     Click for evidence details →                                           │
--│                                                                             │
--│ The study, which followed 10,000 participants over five years, showed      │
--│ significant improvements in cardiovascular health markers.                 │
--│                                                                             │
--│ [🟡 Some experts believe this diet can completely prevent heart attacks]  │
--│     ↑ UNCERTAIN • 45% confidence                                           │
--│     Overstated - evidence shows risk reduction, not prevention             │
--│     Click for details →                                                    │
--│                                                                             │
--│ Dr. Maria Rodriguez, lead researcher, recommends incorporating more        │
--│ olive oil, fish, and vegetables into daily meals.                          │
--│                                                                             │
--│ [🔴 The study proves that saturated fats cause heart disease]             │
--│     ↑ REFUTED • 15% confidence                                             │
--│     Claim not supported by study design; correlation ≠ causation           │
--│     Click for counter-evidence →                                           │
--│                                                                             │
--│ Participants also reported feeling more energetic and experiencing         │
--│ better sleep quality, though these were secondary measures.                │
--│                                                                             │
--└─────────────────────────────────────────────────────────────────────────────┘
--
--Legend:
--🟢 = Well-supported claim (confidence ≥75%)
--🟡 = Uncertain claim (confidence 40-74%)
--🔴 = Refuted/unsupported claim (confidence <40%)
--Plain text = Non-factual content (context, opinions, recommendations)
--{{/code}}
--
--==== Tooltip on Hover/Click ====
--
--{{code language="none"}}
--┌────────────────────────────────────────────────────────────┐
--│ FactHarbor Analysis                                        │
--├────────────────────────────────────────────────────────────┤
--│ Claim:                                                     │
--│ "Researchers found that Mediterranean diet followers had   │
--│  a 25% lower risk of heart disease"                        │
--│                                                            │
--│ Verdict: WELL SUPPORTED                                   │
--│ Confidence: 87%                                            │
--│                                                            │
--│ Evidence Summary:                                          │
--│ • Meta-analysis of 12 RCTs confirms 23-28% risk reduction │
--│ • Consistent findings across multiple populations          │
--│ • Published in peer-reviewed journal (high credibility)    │
--│                                                            │
--│ Uncertainty Factors:                                       │
--│ • Exact percentage varies by study (20-30% range)          │
--│                                                            │
--│ [View Full Analysis →]                                     │
--└────────────────────────────────────────────────────────────┘
--{{/code}}
--
--**Color-Coding System**:
--* **Green**: Well-supported claims (confidence ≥75%, strong evidence)
--* **Yellow/Orange**: Uncertain claims (confidence 40-74%, conflicting or limited evidence)
--* **Red**: Refuted or unsupported claims (confidence <40%, contradicted by evidence)
--* **Gray/Neutral**: Non-factual content (opinions, questions, procedural text)
--
--==== Interactive Highlighting Example (Table Format) ====
--
--|=**Article Text**|=**Highlighting**|=**Tooltip Info**
--|(((A recent study published in the Journal of Nutrition has revealed new findings about the Mediterranean diet.)))|Plain text|//No highlighting - context//
--|(((Researchers found that Mediterranean diet followers had a 25% lower risk of heart disease compared to control groups)))|(% style="background-color:#90EE90; padding:5px;" %)**🟢 HIGHLIGHTED**|(((
--**WELL SUPPORTED** • 87% confidence
--
--Evidence: Meta-analysis of 12 RCTs confirms 23-28% risk reduction
--
--[[View Full Analysis→]]
--)))
--|(((The study, which followed 10,000 participants over five years, showed significant improvements in cardiovascular health markers.)))|Plain text|//No highlighting - methodology//
--|(((Some experts believe this diet can completely prevent heart attacks)))|(% style="background-color:#FFD700; padding:5px;" %)**🟡 HIGHLIGHTED**|(((
--**UNCERTAIN** • 45% confidence
--
--Issue: Overstated - evidence shows risk reduction, not prevention
--
--[[View Details→]]
--)))
--|(((Dr. Rodriguez recommends incorporating more olive oil, fish, and vegetables into daily meals.)))|Plain text|//No highlighting - recommendation//
--|(((The study proves that saturated fats cause heart disease)))|(% style="background-color:#FFB6C6; padding:5px;" %)**🔴 HIGHLIGHTED**|(((
--**REFUTED** • 15% confidence
--
--Issue: Claim not supported by study; correlation ≠ causation
--
--[[View Counter-Evidence→]]
--)))
--
--**User Actions**:
--* **Hover** over highlighted claim → Tooltip appears
--* **Click** highlighted claim → Detailed analysis modal/panel
--* **Toggle** button to turn highlighting on/off
--* **Keyboard**: Tab through highlighted claims
--
--**Interaction Design**:
--* Hover/click on highlighted claim → Show tooltip with:
--  * Claim text
--  * Verdict (e.g., "WELL SUPPORTED")
--  * Confidence score (e.g., "85%")
--  * Brief evidence summary
--  * Link to detailed analysis
--* Toggle highlighting on/off (user preference)
--* Adjustable color intensity for accessibility
--
--**Technical Requirements**:
--* Real-time highlighting as page loads (non-blocking)
--* Claim boundary detection (start/end of assertion)
--* Handle nested or overlapping claims
--* Preserve original article formatting
--* Work with various content formats (HTML, plain text, PDFs)
--
--**Performance Requirements**:
--* Highlighting renders within 500ms of page load
--* No perceptible delay in reading experience
--* Efficient DOM manipulation (avoid reflows)
--
--**Accessibility**:
--* Color-blind friendly palette (use patterns/icons in addition to color)
--* Screen reader compatible (ARIA labels for claim credibility)
--* Keyboard navigation to highlighted claims
--
--**Implementation Notes**:
--* Claims extracted and analyzed by AKEL during initial processing
--* Highlighting data stored as annotations with byte offsets
--* Client-side rendering of highlights based on verdict data
--* Mobile responsive (tap instead of hover)
--
--=== 8.5 Workflow & Moderation ===
--
  ==== FR9 — Publication Workflow ====
  **Fulfills**: UN-1 (Fast access to verified content), UN-16 (Clear review status)
@@ -724,9 +724,8 @@
  * Simple editing (Wikipedia-style)
  * Reputation system
  * Basic moderation
--* In-article claim highlighting (FR13)
--**Additional User Needs fulfilled**: UN-13, UN-17
++**Additional User Needs fulfilled**: UN-13
  **Phase 3 (Months 7-12): Refinement**
@@ -767,17 +767,16 @@
  * UN-7: % users who access evidence details
  * UN-8: % users who view multiple scenarios
  * UN-15: % users who check evolution timeline
--* UN-17: % users who enable in-article highlighting; avg. time spent on highlighted vs. non-highlighted articles
  == 12. Requirements Traceability ==
  For full traceability matrix showing which requirements fulfill which user needs, see:
--* [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] - Section 8 includes comprehensive mapping tables
++* [[User Needs>>FactHarbor.Specification.Requirements.User-Needs]] - Section 8 includes comprehensive mapping tables
  == 13. Related Pages ==
--* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - What users need (drives these requirements)
++* **[[User Needs>>FactHarbor.Specification.Requirements.User-Needs]]** - What users need (drives these requirements)
  * [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] - How requirements are implemented
  * [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting requirements
  * [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows

Changes for page Requirements

Summary

Details

Applications

Navigation

Need help?