Changes for page Requirements

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

From 2.1 to 1.1 From 6.2 to 6.1

From version 6.1

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

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,205 +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 ====
--
--(% class="box" %)
--(((
--**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.
--
--(% class="box successmessage" style="margin:10px 0;" %)
--(((
--🟢 **Researchers found that Mediterranean diet followers had a 25% lower risk of heart disease compared to control groups**
--
--(% style="font-size:0.9em; color:#666;" %)
--↑ 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.
--
--(% class="box warningmessage" style="margin:10px 0;" %)
--(((
--🟡 **Some experts believe this diet can completely prevent heart attacks**
--
--(% style="font-size:0.9em; color:#666;" %)
--↑ 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.
--
--(% class="box errormessage" style="margin:10px 0;" %)
--(((
--🔴 **The study proves that saturated fats cause heart disease**
--
--(% style="font-size:0.9em; color:#666;" %)
--↑ 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)
--
--==== Tooltip on Hover/Click ====
--
--(% class="box infomessage" %)
--(((
--**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 →]]
--)))
--
--**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 (Detailed View) ====
--
--(% style="width:100%; border-collapse:collapse;" %)
--|=**Article Text**|=**Status**|=**Analysis**
--|(((A recent study published in the Journal of Nutrition has revealed new findings about the Mediterranean diet.)))|(% style="text-align:center;" %)Plain text|(% style="font-style:italic; color:#888;" %)Context - no highlighting
--|(((//Researchers found that Mediterranean diet followers had a 25% lower risk of heart disease compared to control groups//)))|(% style="background-color:#D4EDDA; text-align:center; padding:8px;" %)🟢 **WELL SUPPORTED**|(((
--**87% confidence**
--
--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.)))|(% style="text-align:center;" %)Plain text|(% style="font-style:italic; color:#888;" %)Methodology - no highlighting
--|(((//Some experts believe this diet can completely prevent heart attacks//)))|(% style="background-color:#FFF3CD; text-align:center; padding:8px;" %)🟡 **UNCERTAIN**|(((
--**45% confidence**
--
--Overstated - evidence shows risk reduction, not prevention
--
--[[View Details]]
--)))
--|(((Dr. Rodriguez recommends incorporating more olive oil, fish, and vegetables into daily meals.)))|(% style="text-align:center;" %)Plain text|(% style="font-style:italic; color:#888;" %)Recommendation - no highlighting
--|(((//The study proves that saturated fats cause heart disease//)))|(% style="background-color:#F8D7DA; text-align:center; padding:8px;" %)🔴 **REFUTED**|(((
--**15% confidence**
--
--Claim not supported by study; correlation ≠ causation
--
--[[View Counter-Evidence]]
--)))
--
--**Design Notes:**
--* Highlighted claims use italics to distinguish from plain text
--* Color backgrounds match XWiki message box colors (success/warning/error)
--* Status column shows verdict prominently
--* Analysis column provides quick summary with link to details
--
--**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)
@@ -739,9 +739,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**
@@ -782,17 +782,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?