Changes for page Requirements

Summary

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

Details

Page properties

Content

...	...	@@ -32,6 +32,7 @@
32	32	**Who**: Anyone (no login required)
33	33
34	34	**Can**:
	35	+
35	35	* Browse and search claims
36	36	* View scenarios, evidence, verdicts, and confidence scores
37	37	* Flag issues or errors
...	...	@@ -39,6 +39,7 @@
39	39	* Submit claims automatically (new claims added if not duplicates)
40	40
41	41	**Cannot**:
	43	+
42	42	* Modify content
43	43	* Access edit history details
44	44
...	...	@@ -49,6 +49,7 @@
49	49	**Who**: Registered users (earns reputation through contributions)
50	50
51	51	**Can**:
	54	+
52	52	* Everything a Reader can do
53	53	* Edit claims, evidence, and scenarios
54	54	* Add sources and citations
...	...	@@ -57,6 +57,7 @@
57	57	* Earn reputation points for quality contributions
58	58
59	59	**Reputation System**:
	63	+
60	60	* New contributors: Limited edit privileges
61	61	* Established contributors (established reputation): Full edit access
62	62	* Trusted contributors (substantial reputation): Can approve certain changes
...	...	@@ -64,6 +64,7 @@
64	64	* Reputation lost through: Reverted edits, invalid flags, abuse
65	65
66	66	**Cannot**:
	71	+
67	67	* Delete or hide content (only moderators)
68	68	* Override moderation decisions
69	69
...	...	@@ -74,6 +74,7 @@
74	74	**Who**: Trusted community members with proven track record, appointed by governance board
75	75
76	76	**Can**:
	82	+
77	77	* Review flagged content
78	78	* Hide harmful or abusive content
79	79	* Resolve disputes between contributors
...	...	@@ -82,6 +82,7 @@
82	82	* Access full audit logs
83	83
84	84	**Cannot**:
	91	+
85	85	* Change governance rules
86	86	* Permanently ban users without board approval
87	87	* Override technical quality gates
...	...	@@ -95,6 +95,7 @@
95	95	**Not a permanent role**: Contacted externally when needed for contested claims in their domain
96	96
97	97	**When used**:
	105	+
98	98	* Medical claims with life/safety implications
99	99	* Legal interpretations with significant impact
100	100	* Scientific claims with high controversy
...	...	@@ -101,6 +101,7 @@
101	101	* Technical claims requiring specialized knowledge
102	102
103	103	**Process**:
	112	+
104	104	* Moderator identifies need for expert input
105	105	* Contact expert externally (don't require them to be users)
106	106	* Trusted Contributor provides written opinion with sources
...	...	@@ -120,11 +120,13 @@
120	120	**Status**: Visible to all users
121	121
122	122	**Includes**:
	132	+
123	123	* AI-generated analyses (default state)
124	124	* User-contributed content
125	125	* Edited/improved content
126	126
127	127	**Quality Indicators** (displayed with content):
	138	+
128	128	* **Confidence Score**: 0-100% (AI's confidence in analysis)
129	129	* **Source Quality Score**: 0-100% (based on source track record)
130	130	* **Controversy Flag**: If high dispute/edit activity
...	...	@@ -134,6 +134,7 @@
134	134	* **Review Status**: AI-generated / Human-reviewed / Expert-validated
135	135
136	136	**Automatic Warnings**:
	148	+
137	137	* Confidence < 60%: "Low confidence - use caution"
138	138	* Source quality < 40%: "Sources may be unreliable"
139	139	* High controversy: "Disputed - multiple interpretations exist"
...	...	@@ -146,6 +146,7 @@
146	146	**Status**: Not visible to regular users (only to moderators)
147	147
148	148	**Reasons**:
	161	+
149	149	* Spam or advertising
150	150	* Personal attacks or harassment
151	151	* Illegal content
...	...	@@ -154,6 +154,7 @@
154	154	* Abuse or harmful content
155	155
156	156	**Process**:
	170	+
157	157	* Automated detection flags for moderator review
158	158	* Moderator confirms and hides
159	159	* Original author notified with reason
...	...	@@ -176,6 +176,7 @@
176	176	**AKEL is the primary system**. Human contributions supplement and train AKEL.
177	177
178	178	**AKEL Must**:
	193	+
179	179	* Mark all outputs as AI-generated
180	180	* Display confidence scores prominently
181	181	* Provide source citations
...	...	@@ -184,6 +184,7 @@
184	184	* Learn from human corrections
185	185
186	186	**When AKEL Makes Errors**:
	202	+
187	187	1. Capture the error pattern (what, why, how common)
188	188	2. Improve the system (better prompt, model, validation)
189	189	3. Re-process affected claims automatically
...	...	@@ -214,6 +214,7 @@
214	214	=== 4.1 Source Requirements ===
215	215
216	216	**Track Record Over Credentials**:
	233	+
217	217	* Sources evaluated by historical accuracy
218	218	* Correction policy matters
219	219	* Independence from conflicts of interest
...	...	@@ -220,6 +220,7 @@
220	220	* Methodology transparency
221	221
222	222	**Source Quality Database**:
	240	+
223	223	* Automated tracking of source accuracy
224	224	* Correction frequency
225	225	* Reliability score (updated continuously)
...	...	@@ -251,6 +251,7 @@
251	251	=== 4.4 Confidence Scoring ===
252	252
253	253	**Automated confidence calculation based on**:
	272	+
254	254	* Source quality scores
255	255	* Evidence consistency
256	256	* Contradiction detection
...	...	@@ -258,6 +258,7 @@
258	258	* Historical accuracy of similar claims
259	259
260	260	**Thresholds**:
	280	+
261	261	* < 40%: Too low to publish (needs improvement)
262	262	* 40-60%: Published with "Low confidence" warning
263	263	* 60-80%: Published as standard
...	...	@@ -274,6 +274,7 @@
274	274	=== 5.1 Risk Score Calculation ===
275	275
276	276	**Factors** (weighted algorithm):
	297	+
277	277	* **Domain sensitivity**: Medical, legal, safety auto-flagged higher
278	278	* **Potential impact**: Views, citations, spread
279	279	* **Controversy level**: Flags, disputes, edit wars
...	...	@@ -300,6 +300,7 @@
300	300	=== 6.1 Error Capture ===
301	301
302	302	**When users flag errors or make corrections**:
	324	+
303	303	1. What was wrong? (categorize)
304	304	2. What should it have been?
305	305	3. Why did the system fail? (root cause)
...	...	@@ -318,6 +318,7 @@
318	318	=== 6.3 Quality Metrics Dashboard ===
319	319
320	320	**Track continuously**:
	343	+
321	321	* Error rate by category
322	322	* Source quality distribution
323	323	* Confidence score trends
...	...	@@ -343,6 +343,7 @@
343	343	=== 7.2 Anomaly Detection ===
344	344
345	345	**Automated alerts for**:
	369	+
346	346	* Sudden quality drops
347	347	* Unusual patterns
348	348	* Contradiction clusters
...	...	@@ -395,6 +395,7 @@
395	395	**Fulfills**: UN-2 (Context-dependent verification), UN-3 (Article summary with FactHarbor analysis summary), UN-8 (Understanding disagreement)
396	396
397	397	**Automated scenario creation**:
	422	+
398	398	* AKEL analyzes claim and generates likely scenarios (use-cases and contexts)
399	399	* Each scenario includes: assumptions, definitions, boundaries, evidence context
400	400	* Users can flag incorrect scenarios
...	...	@@ -455,6 +455,7 @@
455	455	**Purpose**: Provide side-by-side comparison of what a document claims vs. FactHarbor's complete analysis of its credibility
456	456
457	457	**Left Panel: Article Summary**:
	483	+
458	458	* Document title, source, and claimed credibility
459	459	* "The Big Picture" - main thesis or position change
460	460	* "Key Findings" - structured summary of document's main claims
...	...	@@ -462,6 +462,7 @@
462	462	* "Conclusion" - document's bottom line
463	463
464	464	**Right Panel: FactHarbor Analysis Summary**:
	491	+
465	465	* FactHarbor's independent source credibility assessment
466	466	* Claim-by-claim verdicts with confidence scores
467	467	* Methodology assessment (strengths, limitations)
...	...	@@ -469,6 +469,7 @@
469	469	* Analysis ID for reference
470	470
471	471	**Design Principles**:
	499	+
472	472	* No scrolling required - both panels visible simultaneously
473	473	* Visual distinction between "what they say" and "FactHarbor's analysis"
474	474	* Color coding for verdicts (supported, uncertain, refuted)
...	...	@@ -476,6 +476,7 @@
476	476	* Mobile responsive (panels stack vertically on small screens)
477	477
478	478	**Implementation Notes**:
	507	+
479	479	* Generated automatically by AKEL for every analyzed document
480	480	* Updates when verdict evolves (maintains version history)
481	481	* Exportable as standalone summary report
...	...	@@ -502,7 +502,8 @@
502	502	(% style="font-size:0.9em; color:#666;" %)
503	503	↑ WELL SUPPORTED • 87% confidence
504	504	[[Click for evidence details →]]
505		-(%%)
	534	+
	535	+
506	506	)))
507	507
508	508	The study, which followed 10,000 participants over five years, showed significant improvements in cardiovascular health markers.
...	...	@@ -515,7 +515,8 @@
515	515	↑ UNCERTAIN • 45% confidence
516	516	Overstated - evidence shows risk reduction, not prevention
517	517	[[Click for details →]]
518		-(%%)
	548	+
	549	+
519	519	)))
520	520
521	521	Dr. Maria Rodriguez, lead researcher, recommends incorporating more olive oil, fish, and vegetables into daily meals.
...	...	@@ -528,7 +528,8 @@
528	528	↑ REFUTED • 15% confidence
529	529	Claim not supported by study design; correlation ≠ causation
530	530	[[Click for counter-evidence →]]
531		-(%%)
	562	+
	563	+
532	532	)))
533	533
534	534	Participants also reported feeling more energetic and experiencing better sleep quality, though these were secondary measures.
...	...	@@ -535,6 +535,7 @@
535	535	)))
536	536
537	537	**Legend:**
	570	+
538	538	* 🟢 = Well-supported claim (confidence ≥75%)
539	539	* 🟡 = Uncertain claim (confidence 40-74%)
540	540	* 🔴 = Refuted/unsupported claim (confidence <40%)
...	...	@@ -553,11 +553,13 @@
553	553	**Confidence:** 87%
554	554
555	555	**Evidence Summary:**
	589	+
556	556	* Meta-analysis of 12 RCTs confirms 23-28% risk reduction
557	557	* Consistent findings across multiple populations
558	558	* Published in peer-reviewed journal (high credibility)
559	559
560	560	**Uncertainty Factors:**
	595	+
561	561	* Exact percentage varies by study (20-30% range)
562	562
563	563	[[View Full Analysis →]]
...	...	@@ -564,6 +564,7 @@
564	564	)))
565	565
566	566	**Color-Coding System**:
	602	+
567	567	* **Green**: Well-supported claims (confidence ≥75%, strong evidence)
568	568	* **Yellow/Orange**: Uncertain claims (confidence 40-74%, conflicting or limited evidence)
569	569	* **Red**: Refuted or unsupported claims (confidence <40%, contradicted by evidence)
...	...	@@ -573,8 +573,12 @@
573	573
574	574	(% style="width:100%; border-collapse:collapse;" %)
575	575	|=**Article Text**|=**Status**|=**Analysis**
576		-|(((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
577		-|(((//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**|(((
	612	+|(((
	613	+A recent study published in the Journal of Nutrition has revealed new findings about the Mediterranean diet.
	614	+)))|(% style="text-align:center;" %)Plain text|(% style="font-style:italic; color:#888;" %)Context - no highlighting
	615	+|(((
	616	+//Researchers found that Mediterranean diet followers had a 25% lower risk of heart disease compared to control groups//
	617	+)))|(% style="background-color:#D4EDDA; text-align:center; padding:8px;" %)🟢 **WELL SUPPORTED**|(((
578	578	**87% confidence**
579	579
580	580	Meta-analysis of 12 RCTs confirms 23-28% risk reduction
...	...	@@ -581,8 +581,12 @@
581	581
582	582	[[View Full Analysis]]
583	583	)))
584		-|(((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
585		-|(((//Some experts believe this diet can completely prevent heart attacks//)))|(% style="background-color:#FFF3CD; text-align:center; padding:8px;" %)🟡 **UNCERTAIN**|(((
	624	+|(((
	625	+The study, which followed 10,000 participants over five years, showed significant improvements in cardiovascular health markers.
	626	+)))|(% style="text-align:center;" %)Plain text|(% style="font-style:italic; color:#888;" %)Methodology - no highlighting
	627	+|(((
	628	+//Some experts believe this diet can completely prevent heart attacks//
	629	+)))|(% style="background-color:#FFF3CD; text-align:center; padding:8px;" %)🟡 **UNCERTAIN**|(((
586	586	**45% confidence**
587	587
588	588	Overstated - evidence shows risk reduction, not prevention
...	...	@@ -589,8 +589,12 @@
589	589
590	590	[[View Details]]
591	591	)))
592		-|(((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
593		-|(((//The study proves that saturated fats cause heart disease//)))|(% style="background-color:#F8D7DA; text-align:center; padding:8px;" %)🔴 **REFUTED**|(((
	636	+|(((
	637	+Dr. Rodriguez recommends incorporating more olive oil, fish, and vegetables into daily meals.
	638	+)))|(% style="text-align:center;" %)Plain text|(% style="font-style:italic; color:#888;" %)Recommendation - no highlighting
	639	+|(((
	640	+//The study proves that saturated fats cause heart disease//
	641	+)))|(% style="background-color:#F8D7DA; text-align:center; padding:8px;" %)🔴 **REFUTED**|(((
594	594	**15% confidence**
595	595
596	596	Claim not supported by study; correlation ≠ causation
...	...	@@ -599,6 +599,7 @@
599	599	)))
600	600
601	601	**Design Notes:**
	650	+
602	602	* Highlighted claims use italics to distinguish from plain text
603	603	* Color backgrounds match XWiki message box colors (success/warning/error)
604	604	* Status column shows verdict prominently
...	...	@@ -605,6 +605,7 @@
605	605	* Analysis column provides quick summary with link to details
606	606
607	607	**User Actions**:
	657	+
608	608	* **Hover** over highlighted claim → Tooltip appears
609	609	* **Click** highlighted claim → Detailed analysis modal/panel
610	610	* **Toggle** button to turn highlighting on/off
...	...	@@ -611,16 +611,18 @@
611	611	* **Keyboard**: Tab through highlighted claims
612	612
613	613	**Interaction Design**:
	664	+
614	614	* Hover/click on highlighted claim → Show tooltip with:
615		- * Claim text
616		- * Verdict (e.g., "WELL SUPPORTED")
617		- * Confidence score (e.g., "85%")
618		- * Brief evidence summary
619		- * Link to detailed analysis
	666	+* Claim text
	667	+* Verdict (e.g., "WELL SUPPORTED")
	668	+* Confidence score (e.g., "85%")
	669	+* Brief evidence summary
	670	+* Link to detailed analysis
620	620	* Toggle highlighting on/off (user preference)
621	621	* Adjustable color intensity for accessibility
622	622
623	623	**Technical Requirements**:
	675	+
624	624	* Real-time highlighting as page loads (non-blocking)
625	625	* Claim boundary detection (start/end of assertion)
626	626	* Handle nested or overlapping claims
...	...	@@ -628,16 +628,19 @@
628	628	* Work with various content formats (HTML, plain text, PDFs)
629	629
630	630	**Performance Requirements**:
	683	+
631	631	* Highlighting renders within 500ms of page load
632	632	* No perceptible delay in reading experience
633	633	* Efficient DOM manipulation (avoid reflows)
634	634
635	635	**Accessibility**:
	689	+
636	636	* Color-blind friendly palette (use patterns/icons in addition to color)
637	637	* Screen reader compatible (ARIA labels for claim credibility)
638	638	* Keyboard navigation to highlighted claims
639	639
640	640	**Implementation Notes**:
	695	+
641	641	* Claims extracted and analyzed by AKEL during initial processing
642	642	* Highlighting data stored as annotations with byte offsets
643	643	* Client-side rendering of highlights based on verdict data
...	...	@@ -650,6 +650,7 @@
650	650	**Fulfills**: UN-1 (Fast access to verified content), UN-16 (Clear review status)
651	651
652	652	**Simple flow**:
	708	+
653	653	1. Claim submitted
654	654	2. AKEL processes (automated)
655	655	3. If confidence > threshold: Publish (labeled as AI-generated)
...	...	@@ -661,6 +661,7 @@
661	661	==== FR10 — Moderation ====
662	662
663	663	**Focus on abuse, not routine quality**:
	720	+
664	664	* Automated abuse detection
665	665	* Moderators handle flags
666	666	* Quick response to harmful content
...	...	@@ -723,6 +723,7 @@
723	723	**Phase 1 (Months 1-3): Read-Only MVP**
724	724
725	725	Build:
	783	+
726	726	* Automated claim analysis
727	727	* Confidence scoring
728	728	* Source evaluation
...	...	@@ -736,6 +736,7 @@
736	736	**Phase 2 (Months 4-6): User Contributions**
737	737
738	738	Add only if needed:
	797	+
739	739	* Simple editing (Wikipedia-style)
740	740	* Reputation system
741	741	* Basic moderation
...	...	@@ -752,6 +752,7 @@
752	752	**Additional User Needs fulfilled**: UN-14 (API access), UN-15 (Full evolution tracking)
753	753
754	754	**Deferred**:
	814	+
755	755	* Federation (until multiple successful instances exist)
756	756	* Complex contribution workflows (focus on automation)
757	757	* Extensive role hierarchy (keep simple)
...	...	@@ -759,6 +759,7 @@
759	759	== 11. Success Metrics ==
760	760
761	761	**System Quality** (track weekly):
	822	+
762	762	* Error rate by category (target: -10%/month)
763	763	* Average confidence score (target: increase)
764	764	* Source quality distribution (target: more high-quality)
...	...	@@ -765,6 +765,7 @@
765	765	* Contradiction detection rate (target: increase)
766	766
767	767	**Efficiency** (track monthly):
	829	+
768	768	* Claims processed per hour (target: increase)
769	769	* Human hours per claim (target: decrease)
770	770	* Automation coverage (target: >90%)
...	...	@@ -771,6 +771,7 @@
771	771	* Re-work rate (target: <5%)
772	772
773	773	**User Satisfaction** (track quarterly):
	836	+
774	774	* User flag rate (issues found)
775	775	* Correction acceptance rate (flags valid)
776	776	* Return user rate
...	...	@@ -777,6 +777,7 @@
777	777	* Trust indicators (surveys)
778	778
779	779	**User Needs Metrics** (track quarterly):
	843	+
780	780	* UN-1: % users who understand trust scores
781	781	* UN-4: Time to verify social media claim (target: <30s)
782	782	* UN-7: % users who access evidence details
...	...	@@ -797,5 +797,5 @@
797	797	* [[Data Model>>FactHarbor.Specification.Data Model.WebHome]] - Data structures supporting requirements
798	798	* [[Workflows>>FactHarbor.Specification.Workflows.WebHome]] - User interaction workflows
799	799	* [[AKEL>>FactHarbor.Specification.AI Knowledge Extraction Layer (AKEL).WebHome]] - AI system fulfilling automation requirements
800		-* [[Global Rules>>FactHarbor.Organisation.How-We-Work-Together.GlobalRules.WebHome]]
	864	+* [[Global Rules>>Archive.FactHarbor.Organisation.How-We-Work-Together.GlobalRules.WebHome]]
801	801	* [[Privacy Policy>>FactHarbor.Organisation.How-We-Work-Together.Privacy-Policy]]