Changes for page Requirements

Last modified by Robert Schaub on 2026/02/08 21:32

From 6.1 to 5.1 From 6.4 to 6.3

From version 6.3

edited by Robert Schaub
on 2026/01/20 20:21

Change comment: Renamed back-links.

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 (2 modified, 0 added, 0 removed)

Details

Page properties

Parent

@@ -1,1 +1,1 @@
--Archive.FactHarbor V0\.9\.50 Plus (Prev Rel).Specification.WebHome
++FactHarbor.Specification.WebHome

Content

@@ -32,7 +32,6 @@
  **Who**: Anyone (no login required)
  **Can**:
--
  * Browse and search claims
  * View scenarios, evidence, verdicts, and confidence scores
  * Flag issues or errors
@@ -40,7 +40,6 @@
  * Submit claims automatically (new claims added if not duplicates)
  **Cannot**:
--
  * Modify content
  * Access edit history details
@@ -51,7 +51,6 @@
  **Who**: Registered users (earns reputation through contributions)
  **Can**:
--
  * Everything a Reader can do
  * Edit claims, evidence, and scenarios
  * Add sources and citations
@@ -60,7 +60,6 @@
  * Earn reputation points for quality contributions
  **Reputation System**:
--
  * New contributors: Limited edit privileges
  * Established contributors (established reputation): Full edit access
  * Trusted contributors (substantial reputation): Can approve certain changes
@@ -68,7 +68,6 @@
  * Reputation lost through: Reverted edits, invalid flags, abuse
  **Cannot**:
--
  * Delete or hide content (only moderators)
  * Override moderation decisions
@@ -79,7 +79,6 @@
  **Who**: Trusted community members with proven track record, appointed by governance board
  **Can**:
--
  * Review flagged content
  * Hide harmful or abusive content
  * Resolve disputes between contributors
@@ -88,7 +88,6 @@
  * Access full audit logs
  **Cannot**:
--
  * Change governance rules
  * Permanently ban users without board approval
  * Override technical quality gates
@@ -102,7 +102,6 @@
  **Not a permanent role**: Contacted externally when needed for contested claims in their domain
  **When used**:
--
  * Medical claims with life/safety implications
  * Legal interpretations with significant impact
  * Scientific claims with high controversy
@@ -109,7 +109,6 @@
  * Technical claims requiring specialized knowledge
  **Process**:
--
  * Moderator identifies need for expert input
  * Contact expert externally (don't require them to be users)
  * Trusted Contributor provides written opinion with sources
@@ -129,13 +129,11 @@
  **Status**: Visible to all users
  **Includes**:
--
  * AI-generated analyses (default state)
  * User-contributed content
  * Edited/improved content
  **Quality Indicators** (displayed with content):
--
  * **Confidence Score**: 0-100% (AI's confidence in analysis)
  * **Source Quality Score**: 0-100% (based on source track record)
  * **Controversy Flag**: If high dispute/edit activity
@@ -145,7 +145,6 @@
  * **Review Status**: AI-generated / Human-reviewed / Expert-validated
  **Automatic Warnings**:
--
  * Confidence < 60%: "Low confidence - use caution"
  * Source quality < 40%: "Sources may be unreliable"
  * High controversy: "Disputed - multiple interpretations exist"
@@ -158,7 +158,6 @@
  **Status**: Not visible to regular users (only to moderators)
  **Reasons**:
--
  * Spam or advertising
  * Personal attacks or harassment
  * Illegal content
@@ -167,7 +167,6 @@
  * Abuse or harmful content
  **Process**:
--
  * Automated detection flags for moderator review
  * Moderator confirms and hides
  * Original author notified with reason
@@ -190,7 +190,6 @@
  **AKEL is the primary system**. Human contributions supplement and train AKEL.
  **AKEL Must**:
--
  * Mark all outputs as AI-generated
  * Display confidence scores prominently
  * Provide source citations
@@ -199,7 +199,6 @@
  * Learn from human corrections
  **When AKEL Makes Errors**:
--
 . Capture the error pattern (what, why, how common)
 . Improve the system (better prompt, model, validation)
 . Re-process affected claims automatically
@@ -230,7 +230,6 @@
  === 4.1 Source Requirements ===
  **Track Record Over Credentials**:
--
  * Sources evaluated by historical accuracy
  * Correction policy matters
  * Independence from conflicts of interest
@@ -237,7 +237,6 @@
  * Methodology transparency
  **Source Quality Database**:
--
  * Automated tracking of source accuracy
  * Correction frequency
  * Reliability score (updated continuously)
@@ -269,7 +269,6 @@
  === 4.4 Confidence Scoring ===
  **Automated confidence calculation based on**:
--
  * Source quality scores
  * Evidence consistency
  * Contradiction detection
@@ -277,7 +277,6 @@
  * Historical accuracy of similar claims
  **Thresholds**:
--
  * < 40%: Too low to publish (needs improvement)
  * 40-60%: Published with "Low confidence" warning
  * 60-80%: Published as standard
@@ -294,7 +294,6 @@
  === 5.1 Risk Score Calculation ===
  **Factors** (weighted algorithm):
--
  * **Domain sensitivity**: Medical, legal, safety auto-flagged higher
  * **Potential impact**: Views, citations, spread
  * **Controversy level**: Flags, disputes, edit wars
@@ -321,7 +321,6 @@
  === 6.1 Error Capture ===
  **When users flag errors or make corrections**:
--
 . What was wrong? (categorize)
 . What should it have been?
 . Why did the system fail? (root cause)
@@ -340,7 +340,6 @@
  === 6.3 Quality Metrics Dashboard ===
  **Track continuously**:
--
  * Error rate by category
  * Source quality distribution
  * Confidence score trends
@@ -366,7 +366,6 @@
  === 7.2 Anomaly Detection ===
  **Automated alerts for**:
--
  * Sudden quality drops
  * Unusual patterns
  * Contradiction clusters
@@ -419,7 +419,6 @@
  **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)
  * Each scenario includes: assumptions, definitions, boundaries, evidence context
  * Users can flag incorrect scenarios
@@ -480,7 +480,6 @@
  **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
@@ -488,7 +488,6 @@
  * "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)
@@ -496,7 +496,6 @@
  * 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)
@@ -504,7 +504,6 @@
  * 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
@@ -531,8 +531,7 @@
  (% 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.
@@ -545,8 +545,7 @@
  ↑ 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.
@@ -559,8 +559,7 @@
  ↑ 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.
@@ -567,7 +567,6 @@
  )))
  **Legend:**
--
  * 🟢 = Well-supported claim (confidence ≥75%)
  * 🟡 = Uncertain claim (confidence 40-74%)
  * 🔴 = Refuted/unsupported claim (confidence <40%)
@@ -586,13 +586,11 @@
  **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 →]]
@@ -599,7 +599,6 @@
  )))
  **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)
@@ -609,12 +609,8 @@
  (% 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**|(((
++|(((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
@@ -621,12 +621,8 @@
  [[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**|(((
++|(((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
@@ -633,12 +633,8 @@
  [[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**|(((
++|(((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
@@ -647,7 +647,6 @@
  )))
  **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
@@ -654,7 +654,6 @@
  * 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
@@ -661,18 +661,16 @@
  * **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
++  * 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
@@ -680,19 +680,16 @@
  * 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
@@ -705,7 +705,6 @@
  **Fulfills**: UN-1 (Fast access to verified content), UN-16 (Clear review status)
  **Simple flow**:
--
 . Claim submitted
 . AKEL processes (automated)
 . If confidence > threshold: Publish (labeled as AI-generated)
@@ -717,7 +717,6 @@
  ==== FR10 — Moderation ====
  **Focus on abuse, not routine quality**:
--
  * Automated abuse detection
  * Moderators handle flags
  * Quick response to harmful content
@@ -780,7 +780,6 @@
  **Phase 1 (Months 1-3): Read-Only MVP**
  Build:
--
  * Automated claim analysis
  * Confidence scoring
  * Source evaluation
@@ -794,7 +794,6 @@
  **Phase 2 (Months 4-6): User Contributions**
  Add only if needed:
--
  * Simple editing (Wikipedia-style)
  * Reputation system
  * Basic moderation
@@ -811,7 +811,6 @@
  **Additional User Needs fulfilled**: UN-14 (API access), UN-15 (Full evolution tracking)
  **Deferred**:
--
  * Federation (until multiple successful instances exist)
  * Complex contribution workflows (focus on automation)
  * Extensive role hierarchy (keep simple)
@@ -819,7 +819,6 @@
  == 11. Success Metrics ==
  **System Quality** (track weekly):
--
  * Error rate by category (target: -10%/month)
  * Average confidence score (target: increase)
  * Source quality distribution (target: more high-quality)
@@ -826,7 +826,6 @@
  * Contradiction detection rate (target: increase)
  **Efficiency** (track monthly):
--
  * Claims processed per hour (target: increase)
  * Human hours per claim (target: decrease)
  * Automation coverage (target: >90%)
@@ -833,7 +833,6 @@
  * Re-work rate (target: <5%)
  **User Satisfaction** (track quarterly):
--
  * User flag rate (issues found)
  * Correction acceptance rate (flags valid)
  * Return user rate
@@ -840,7 +840,6 @@
  * Trust indicators (surveys)
  **User Needs Metrics** (track quarterly):
--
  * UN-1: % users who understand trust scores
  * UN-4: Time to verify social media claim (target: <30s)
  * UN-7: % users who access evidence details
@@ -861,5 +861,5 @@
  * [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting requirements
  * [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows
  * [[AKEL>>FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation requirements
--* [[Global Rules>>Archive.FactHarbor.Organisation.How-We-Work-Together.GlobalRules.WebHome]]
++* [[Global Rules>>FactHarbor.Organisation.How-We-Work-Together.GlobalRules.WebHome]]
  * [[Privacy Policy>>FactHarbor.Organisation.How-We-Work-Together.Privacy-Policy]]

Changes for page Requirements

Summary

Details

Applications

Navigation

Need help?