Changes for page Requirements

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

From 1.1 to 2.1 From 6.1 to 6.2

From version 2.1

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

Change comment: There is no comment for this version

To version 6.1

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

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]]** - What users need from FactHarbor (drives these requirements)
++* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - 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]] for what users need
++1. **User Needs drive Requirements**: See [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] 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 (Summary + verdict), UN-4 (Social media fact-checking), UN-5 (Source tracing), UN-7 (Evidence transparency), UN-8 (Understanding disagreement), UN-12 (Submit claims)
++**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)
  === 1.2 Contributor ===
@@ -392,7 +392,7 @@
  ==== FR4 — Scenario Generation ====
--**Fulfills**: UN-2 (Context-dependent verification), UN-3 (Summary with scenarios), UN-8 (Understanding disagreement)
++**Fulfills**: UN-2 (Context-dependent verification), UN-3 (Article summary with FactHarbor analysis summary), 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 (Summary with verdicts), UN-8 (Understanding disagreement)
++**Fulfills**: UN-3 (Article summary with FactHarbor analysis summary), 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 (Verdict summaries), UN-13 (Cite verdicts)
++**Fulfills**: UN-1 (Trust score), UN-2 (Verification verdicts), UN-3 (Article summary with FactHarbor analysis summary), 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,8 +446,205 @@
  * Confidence score trends visible
  * Users can see "as of date X, what did we know?"
--=== 8.4 Workflow & Moderation ===
++=== 8.4 User Interface & Presentation ===
++==== 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)
@@ -542,8 +542,9 @@
  * Simple editing (Wikipedia-style)
  * Reputation system
  * Basic moderation
++* In-article claim highlighting (FR13)
--**Additional User Needs fulfilled**: UN-13
++**Additional User Needs fulfilled**: UN-13, UN-17
  **Phase 3 (Months 7-12): Refinement**
@@ -584,16 +584,17 @@
  * 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]] - Section 8 includes comprehensive mapping tables
++* [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] - Section 8 includes comprehensive mapping tables
  == 13. Related Pages ==
--* **[[User Needs>>FactHarbor.Specification.Requirements.User-Needs]]** - What users need (drives these requirements)
++* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - 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?