Changes for page Requirements

Summary

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

Details

Page properties

Content

...	...	@@ -42,7 +42,7 @@
42	42	* Modify content
43	43	* Access edit history details
44	44
45		-**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)
	45	+**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)
46	46
47	47	=== 1.2 Contributor ===
48	48
...	...	@@ -481,6 +481,153 @@
481	481	* Exportable as standalone summary report
482	482	* Shareable via permanent URL
483	483
	484	+==== FR13 — In-Article Claim Highlighting ====
	485	+
	486	+**Fulfills**: UN-17 (In-article claim highlighting)
	487	+
	488	+**Purpose**: Enable readers to quickly assess claim credibility while reading by visually highlighting factual claims with color-coded indicators
	489	+
	490	+==== Visual Example: Article with Highlighted Claims ====
	491	+
	492	+{{code language="none"}}
	493	+┌─────────────────────────────────────────────────────────────────────────────┐
	494	+│ Article: "New Study Shows Benefits of Mediterranean Diet" │
	495	+├─────────────────────────────────────────────────────────────────────────────┤
	496	+│ │
	497	+│ A recent study published in the Journal of Nutrition has revealed new │
	498	+│ findings about the Mediterranean diet. │
	499	+│ │
	500	+│ [🟢 Researchers found that Mediterranean diet followers had a 25% lower │
	501	+│ risk of heart disease compared to control groups] │
	502	+│ ↑ WELL SUPPORTED • 87% confidence │
	503	+│ Click for evidence details → │
	504	+│ │
	505	+│ The study, which followed 10,000 participants over five years, showed │
	506	+│ significant improvements in cardiovascular health markers. │
	507	+│ │
	508	+│ [🟡 Some experts believe this diet can completely prevent heart attacks] │
	509	+│ ↑ UNCERTAIN • 45% confidence │
	510	+│ Overstated - evidence shows risk reduction, not prevention │
	511	+│ Click for details → │
	512	+│ │
	513	+│ Dr. Maria Rodriguez, lead researcher, recommends incorporating more │
	514	+│ olive oil, fish, and vegetables into daily meals. │
	515	+│ │
	516	+│ [🔴 The study proves that saturated fats cause heart disease] │
	517	+│ ↑ REFUTED • 15% confidence │
	518	+│ Claim not supported by study design; correlation ≠ causation │
	519	+│ Click for counter-evidence → │
	520	+│ │
	521	+│ Participants also reported feeling more energetic and experiencing │
	522	+│ better sleep quality, though these were secondary measures. │
	523	+│ │
	524	+└─────────────────────────────────────────────────────────────────────────────┘
	525	+
	526	+Legend:
	527	+🟢 = Well-supported claim (confidence ≥75%)
	528	+🟡 = Uncertain claim (confidence 40-74%)
	529	+🔴 = Refuted/unsupported claim (confidence <40%)
	530	+Plain text = Non-factual content (context, opinions, recommendations)
	531	+{{/code}}
	532	+
	533	+==== Tooltip on Hover/Click ====
	534	+
	535	+{{code language="none"}}
	536	+┌────────────────────────────────────────────────────────────┐
	537	+│ FactHarbor Analysis │
	538	+├────────────────────────────────────────────────────────────┤
	539	+│ Claim: │
	540	+│ "Researchers found that Mediterranean diet followers had │
	541	+│ a 25% lower risk of heart disease" │
	542	+│ │
	543	+│ Verdict: WELL SUPPORTED │
	544	+│ Confidence: 87% │
	545	+│ │
	546	+│ Evidence Summary: │
	547	+│ • Meta-analysis of 12 RCTs confirms 23-28% risk reduction │
	548	+│ • Consistent findings across multiple populations │
	549	+│ • Published in peer-reviewed journal (high credibility) │
	550	+│ │
	551	+│ Uncertainty Factors: │
	552	+│ • Exact percentage varies by study (20-30% range) │
	553	+│ │
	554	+│ [View Full Analysis →] │
	555	+└────────────────────────────────────────────────────────────┘
	556	+{{/code}}
	557	+
	558	+**Color-Coding System**:
	559	+* **Green**: Well-supported claims (confidence ≥75%, strong evidence)
	560	+* **Yellow/Orange**: Uncertain claims (confidence 40-74%, conflicting or limited evidence)
	561	+* **Red**: Refuted or unsupported claims (confidence <40%, contradicted by evidence)
	562	+* **Gray/Neutral**: Non-factual content (opinions, questions, procedural text)
	563	+
	564	+==== Interactive Highlighting Example (Table Format) ====
	565	+
	566	+|=**Article Text**|=**Highlighting**|=**Tooltip Info**
	567	+|(((A recent study published in the Journal of Nutrition has revealed new findings about the Mediterranean diet.)))|Plain text|//No highlighting - context//
	568	+|(((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**|(((
	569	+**WELL SUPPORTED** • 87% confidence
	570	+
	571	+Evidence: Meta-analysis of 12 RCTs confirms 23-28% risk reduction
	572	+
	573	+[[View Full Analysis→]]
	574	+)))
	575	+|(((The study, which followed 10,000 participants over five years, showed significant improvements in cardiovascular health markers.)))|Plain text|//No highlighting - methodology//
	576	+|(((Some experts believe this diet can completely prevent heart attacks)))|(% style="background-color:#FFD700; padding:5px;" %)**🟡 HIGHLIGHTED**|(((
	577	+**UNCERTAIN** • 45% confidence
	578	+
	579	+Issue: Overstated - evidence shows risk reduction, not prevention
	580	+
	581	+[[View Details→]]
	582	+)))
	583	+|(((Dr. Rodriguez recommends incorporating more olive oil, fish, and vegetables into daily meals.)))|Plain text|//No highlighting - recommendation//
	584	+|(((The study proves that saturated fats cause heart disease)))|(% style="background-color:#FFB6C6; padding:5px;" %)**🔴 HIGHLIGHTED**|(((
	585	+**REFUTED** • 15% confidence
	586	+
	587	+Issue: Claim not supported by study; correlation ≠ causation
	588	+
	589	+[[View Counter-Evidence→]]
	590	+)))
	591	+
	592	+**User Actions**:
	593	+* **Hover** over highlighted claim → Tooltip appears
	594	+* **Click** highlighted claim → Detailed analysis modal/panel
	595	+* **Toggle** button to turn highlighting on/off
	596	+* **Keyboard**: Tab through highlighted claims
	597	+
	598	+**Interaction Design**:
	599	+* Hover/click on highlighted claim → Show tooltip with:
	600	+ * Claim text
	601	+ * Verdict (e.g., "WELL SUPPORTED")
	602	+ * Confidence score (e.g., "85%")
	603	+ * Brief evidence summary
	604	+ * Link to detailed analysis
	605	+* Toggle highlighting on/off (user preference)
	606	+* Adjustable color intensity for accessibility
	607	+
	608	+**Technical Requirements**:
	609	+* Real-time highlighting as page loads (non-blocking)
	610	+* Claim boundary detection (start/end of assertion)
	611	+* Handle nested or overlapping claims
	612	+* Preserve original article formatting
	613	+* Work with various content formats (HTML, plain text, PDFs)
	614	+
	615	+**Performance Requirements**:
	616	+* Highlighting renders within 500ms of page load
	617	+* No perceptible delay in reading experience
	618	+* Efficient DOM manipulation (avoid reflows)
	619	+
	620	+**Accessibility**:
	621	+* Color-blind friendly palette (use patterns/icons in addition to color)
	622	+* Screen reader compatible (ARIA labels for claim credibility)
	623	+* Keyboard navigation to highlighted claims
	624	+
	625	+**Implementation Notes**:
	626	+* Claims extracted and analyzed by AKEL during initial processing
	627	+* Highlighting data stored as annotations with byte offsets
	628	+* Client-side rendering of highlights based on verdict data
	629	+* Mobile responsive (tap instead of hover)
	630	+
484	484	=== 8.5 Workflow & Moderation ===
485	485
486	486	==== FR9 — Publication Workflow ====
...	...	@@ -577,8 +577,9 @@
577	577	* Simple editing (Wikipedia-style)
578	578	* Reputation system
579	579	* Basic moderation
	727	+* In-article claim highlighting (FR13)
580	580
581		-**Additional User Needs fulfilled**: UN-13
	729	+**Additional User Needs fulfilled**: UN-13, UN-17
582	582
583	583	**Phase 3 (Months 7-12): Refinement**
584	584
...	...	@@ -619,6 +619,7 @@
619	619	* UN-7: % users who access evidence details
620	620	* UN-8: % users who view multiple scenarios
621	621	* UN-15: % users who check evolution timeline
	770	+* UN-17: % users who enable in-article highlighting; avg. time spent on highlighted vs. non-highlighted articles
622	622
623	623	== 12. Requirements Traceability ==
624	624