Skip to content

Commit 3396ec2

Browse files
Jonathan D.A. Jewellclaude
andcommitted
fix: Restore original README content
The previous RSR standardization commit accidentally replaced the full README content with a minimal template. This restores the original project documentation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent c1df842 commit 3396ec2

File tree

1 file changed

+145
-53
lines changed

1 file changed

+145
-53
lines changed

README.adoc

Lines changed: 145 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -1,76 +1,168 @@
1-
= im-docs
2-
Jonathan D.A. Jewell <jonathan.jewell@gmail.com>
3-
:toc: macro
4-
:icons: font
5-
:source-highlighter: rouge
6-
:experimental:
7-
:url-github: https://github.com/hyperpolymath/im-docs
8-
:url-gitlab: https://gitlab.com/hyperpolymath/im-docs
9-
:url-bitbucket: https://bitbucket.org/hyperpolymath/im-docs
10-
:url-codeberg: https://codeberg.org/hyperpolymath/im-docs
1+
= Wayfinder: Epistemic Infrastructure for Journalism
112

12-
Instant messaging documentation generator
3+
*Status*: Conceptual Design → Proof of Concept Development
134

14-
image:https://img.shields.io/badge/RSR-Certified-gold[RSR Certified]
15-
image:https://img.shields.io/badge/License-AGPL%20v3-blue[License]
5+
Wayfinder is a heutagogic capability development pathway and interactive journalism framework designed to transform journalism from static truth-claims into navigable knowledge ecosystems.
166

17-
toc::[]
7+
== The Problem
188

19-
== Overview
9+
We haven't moved from "Truth to Post-Truth" but from an era where knowledge systems were simpler to one where they're overwhelmed by data velocity. *Data is outpacing knowledge, intelligence, and wisdom.*
2010

21-
im-docs is part of the link:https://rhodium.sh[Rhodium Standard] (RSR) ecosystem.
11+
Traditional journalism says: "Here's what happened."
12+
Wayfinder says: "Here's the evidence ecosystem. Navigate it. Understand how we know."
2213

23-
Domain: *software-development*
14+
== The Solution
2415

25-
== Installation
16+
Wayfinder creates *boundary objects*—interactive investigations that serve different communities while maintaining evidential coherence:
2617

27-
[source,bash]
28-
----
29-
# Clone from GitHub (primary)
30-
git clone {url-github}
18+
- *Activists*: Tool for mobilization
19+
- *Policymakers*: Decision support system
20+
- *Academics*: Research resource
21+
- *Skeptics*: Challenge mechanism
22+
- *Affected Communities*: Validation and voice
23+
- *Journalists*: Living investigation
3124

32-
# Or from mirrors
33-
git clone {url-gitlab}
34-
git clone {url-codeberg}
35-
----
25+
All use the SAME evidence but interpret it for their needs. This enables *coordination without consensus*.
3626

37-
== RSR Stack
27+
== Core Framework: PROMPT
3828

39-
This project follows RSR conventions:
29+
Every claim is evaluated across six dimensions:
4030

41-
* ✅ ReScript for frontend/logic
42-
* ✅ Deno for JS runtime
43-
* ✅ WASM for performance-critical code
44-
* ✅ Rust/OCaml/Haskell for systems/proofs
45-
* ✅ Guile/Scheme for configuration
46-
* ❌ No TypeScript
47-
* ❌ No Go
48-
* ❌ No npm
31+
- *P*rovenance: Who said it? What's their track record?
32+
- *R*elevance: Does this actually address the claim?
33+
- *O*bjectivity: What biases exist? Are they disclosed?
34+
- *M*ethods: How was evidence gathered? Is it sound?
35+
- *P*erspective: What viewpoints are represented? What's missing?
36+
- *T*imeliness: Is this current? Has it been superseded?
4937

50-
== Mirrors
38+
== Knowledge Pipeline: Data → Knowledge → Intelligence → Wisdom
5139

52-
[cols="1,2"]
53-
|===
54-
| Platform | URL
40+
Traditional journalism conflates all four. Wayfinder separates and makes each navigable:
5541

56-
| GitHub (primary) | {url-github}
57-
| GitLab | {url-gitlab}
58-
| Bitbucket | {url-bitbucket}
59-
| Codeberg | {url-codeberg}
60-
|===
42+
1. *Data Layer*: Raw evidence, fully accessible
43+
2. *Knowledge Layer*: Structured claims with PROMPT analysis
44+
3. *Intelligence Layer*: Pattern recognition, contradiction identification
45+
4. *Wisdom Layer*: Practical reasoning for decision-making
46+
47+
== For Demoralized Journalists
48+
49+
> "You're not obsolete. You're needed more than ever—but as Wayfinders, not gatekeepers. People need guides who show them HOW to navigate complexity, not just WHAT to believe."
50+
51+
=== The Learning Pathway
52+
53+
Self-directed, result-focused capability development:
54+
55+
- *Level 1* (4-8 hours): Evidence Mapper - Map one claim's evidence using PROMPT
56+
- *Level 2A* (8-12 hours): Process Documentarian - Show your methodology transparently
57+
- *Level 2B* (6-10 hours): Uncertainty Communicator - Replace false certainty with honest uncertainty
58+
- *Level 3* (20-40 hours): Knowledge Architect - Create full interactive investigation
59+
- *Level 4* (Ongoing): Epistemic Infrastructure Builder - Build tools, teach others
60+
61+
Each level produces *usable professional outputs*, not just learning badges.
62+
63+
== Quick Start
64+
65+
=== For Beta Testers (Journalists)
66+
67+
1. *Read*: [claude.md](./claude.md) for full context
68+
2. *Try*: Level 1 Evidence Mapping (4 hours)
69+
- Choose one claim you're currently reporting
70+
- Apply PROMPT framework to evaluate evidence
71+
- See immediate value in your work
72+
3. *Decide*: Continue or not (no pressure)
73+
74+
=== For Academic Partners
75+
76+
- *PhD Integration*: This research can be dissertation work
77+
- *Curriculum Development*: Level 1-3 as journalism course modules
78+
- *Research Questions*: Measuring impact on comprehension, trust, behavior change
79+
80+
=== For Developers
81+
82+
- *Phase 1* (NOW): Obsidian/TiddlyWiki/Notion prototypes
83+
- *Phase 2* (3-9 months): SvelteKit + PostgreSQL + graph database custom platform
84+
- *Phase 3* (9-18 months): Ecosystem building, community tools
85+
86+
== Theoretical Foundations
87+
88+
=== Boundary Objects (Susan Leigh Star)
89+
Objects that maintain coherence across communities while adapting to local needs, enabling coordination without consensus.
90+
91+
=== Cognitive Science Integration
92+
- Progressive disclosure (avoid cognitive overload)
93+
- Meta-cognitive prompts (make thinking visible)
94+
- Empathy-first contradictory evidence (reduce defensiveness)
95+
- Transparent navigation analytics (show exploration patterns)
96+
97+
=== Bio-Psycho-Social-Technical Systems
98+
Designed considering biological attention limits, psychological identity protection, social collective sense-making, and technical accessibility requirements.
99+
100+
== Project Status
101+
102+
=== Completed
103+
- ✅ Conceptual framework (PROMPT, boundary objects, heutagogic design)
104+
- ✅ Four-level capability pathway design
105+
- ✅ Cognitive science integration
106+
- ✅ SWOT analysis
107+
- ✅ Technical architecture planning
108+
109+
=== In Progress
110+
- 🔄 Level 1 materials development
111+
- 🔄 Evidence mapping templates
112+
- 🔄 First example investigation
113+
114+
=== Next Steps (Week 1-4)
115+
- Week 1: Document Level 1 pathway, create evidence mapping template, build one example
116+
- Week 2: Share with 3 journalist friends for feedback
117+
- Week 3: Build simple website (GitLab Pages)
118+
- Week 4: First 5-10 participants start Level 1
119+
120+
== Key Documents
121+
122+
- *[claude.md](./claude.md)*: Comprehensive project documentation for AI assistants
123+
- *[CONTRIBUTING.md](./CONTRIBUTING.md)*: How to contribute to Wayfinder
124+
- *[CODE_OF_CONDUCT.md](./CODE_OF_CONDUCT.md)*: Community standards
125+
- *[SECURITY.md](./SECURITY.md)*: Security and transparency policies
126+
127+
== Contact & Collaboration
128+
129+
*Looking For*:
130+
- Beta-testing journalists (especially demoralized ones!)
131+
- Academic partners (journalism schools, media studies)
132+
- Funders (Knight Foundation, Omidyar Network, European Media & Information Fund)
133+
- Developers (SvelteKit, PostgreSQL, D3.js)
134+
- i-Docs practitioners
135+
- Cognitive scientists interested in epistemic interfaces
136+
137+
*Philosophy*: Build in public, open source from day one, collaborative not competitive.
61138

62139
== License
63140

64-
Licensed under AGPL-3.0-or-later OR LicenseRef-Palimpsest-0.5.
141+
This project is dual-licensed:
142+
- MIT License (for maximum compatibility and adoption)
143+
- Palimpsest License v0.8 (for values alignment and ethical use)
144+
145+
See [LICENSE.txt](./LICENSE.txt) for full details.
146+
147+
== Acknowledgments
65148

66-
See link:LICENSE[LICENSE] for details.
149+
=== Intellectual Foundations
150+
- *Nico Carpentier*: Participatory communication theory, PhD supervision
151+
- *Susan Leigh Star*: Boundary objects theory
152+
- *i-Docs Research Network*: Interactive documentary frameworks
153+
- *National Union of Journalists (NUJ)*: Professional journalism practice insights
67154

68-
== Contributing
155+
=== Inspiration
156+
- Interactive documentaries: Out My Window, Hollow, Welcome to Pine Point, Prison Valley
157+
- Tools: Korsakow (non-linear documentary), Klynt, Obsidian, TiddlyWiki
158+
- Cognitive science: Cowan, Schwartz, Kahan, Nickerson
159+
- Epistemology: Wittgenstein (late work on language games), Dempster-Shafer theory
160+
- Media theory: De Man, Derrida (irony), David Foster Wallace (New Sincerity)
69161

70-
See link:CONTRIBUTING.adoc[CONTRIBUTING.adoc].
162+
---
71163

72-
== Metadata
164+
*Version*: 0.1.0-alpha
165+
*Last Updated*: 2025-11-23
166+
*Status*: Pre-release conceptual design
73167

74-
* Domain: software-development
75-
* Framework: RSR (Rhodium Standard Repository)
76-
* Dublin Core: link:.well-known/dc.xml[.well-known/dc.xml]
168+
*For AI assistants: See [claude.md](./claude.md) for full context and implementation details.*

0 commit comments

Comments
 (0)