Skip to Content

Changes for page Requirements

Last modified by Robert Schaub on 2025/12/24 21:46
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 3.1
edited by Robert Schaub
on 2025/12/19 09:57
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -6,7 +6,7 @@
6 6  
7 7  == Navigation ==
8 8  
9 -* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - What users need from FactHarbor (drives these requirements)
9 +* **[[User Needs>>FactHarbor.Specification.Requirements.User-Needs]]** - What users need from FactHarbor (drives these requirements)
10 10  * **This page** - How we fulfill those needs through system design
11 11  
12 12  (% class="box infomessage" %)
... ... @@ -13,7 +13,7 @@
13 13  (((
14 14  **How to read this page:**
15 15  
16 -1. **User Needs drive Requirements**: See [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] for what users need
16 +1. **User Needs drive Requirements**: See [[User Needs>>FactHarbor.Specification.Requirements.User-Needs]] for what users need
17 17  2. **Requirements define implementation**: This page shows how we fulfill those needs
18 18  3. **Functional Requirements (FR)**: Specific features and capabilities
19 19  4. **Non-Functional Requirements (NFR)**: Quality attributes (performance, security, etc.)
... ... @@ -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), UN-17 (In-article highlighting)
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)
46 46  
47 47  === 1.2 Contributor ===
48 48  
... ... @@ -481,153 +481,6 @@
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 -
631 631  === 8.5 Workflow & Moderation ===
632 632  
633 633  ==== FR9 — Publication Workflow ====
... ... @@ -724,9 +724,8 @@
724 724  * Simple editing (Wikipedia-style)
725 725  * Reputation system
726 726  * Basic moderation
727 -* In-article claim highlighting (FR13)
728 728  
729 -**Additional User Needs fulfilled**: UN-13, UN-17
581 +**Additional User Needs fulfilled**: UN-13
730 730  
731 731  **Phase 3 (Months 7-12): Refinement**
732 732  
... ... @@ -767,17 +767,16 @@
767 767  * UN-7: % users who access evidence details
768 768  * UN-8: % users who view multiple scenarios
769 769  * 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
771 771  
772 772  == 12. Requirements Traceability ==
773 773  
774 774  For full traceability matrix showing which requirements fulfill which user needs, see:
775 775  
776 -* [[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]] - Section 8 includes comprehensive mapping tables
627 +* [[User Needs>>FactHarbor.Specification.Requirements.User-Needs]] - Section 8 includes comprehensive mapping tables
777 777  
778 778  == 13. Related Pages ==
779 779  
780 -* **[[User Needs>>FactHarbor.Specification.Requirements.User Needs.WebHome]]** - What users need (drives these requirements)
631 +* **[[User Needs>>FactHarbor.Specification.Requirements.User-Needs]]** - What users need (drives these requirements)
781 781  * [[Architecture>>FactHarbor.Specification.Architecture.WebHome]] - How requirements are implemented
782 782  * [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting requirements
783 783  * [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows