|
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 |
11 | 2 |
|
12 | | -Instant messaging documentation generator |
| 3 | +*Status*: Conceptual Design → Proof of Concept Development |
13 | 4 |
|
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. |
16 | 6 |
|
17 | | -toc::[] |
| 7 | +== The Problem |
18 | 8 |
|
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.* |
20 | 10 |
|
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." |
22 | 13 |
|
23 | | -Domain: *software-development* |
| 14 | +== The Solution |
24 | 15 |
|
25 | | -== Installation |
| 16 | +Wayfinder creates *boundary objects*—interactive investigations that serve different communities while maintaining evidential coherence: |
26 | 17 |
|
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 |
31 | 24 |
|
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*. |
36 | 26 |
|
37 | | -== RSR Stack |
| 27 | +== Core Framework: PROMPT |
38 | 28 |
|
39 | | -This project follows RSR conventions: |
| 29 | +Every claim is evaluated across six dimensions: |
40 | 30 |
|
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? |
49 | 37 |
|
50 | | -== Mirrors |
| 38 | +== Knowledge Pipeline: Data → Knowledge → Intelligence → Wisdom |
51 | 39 |
|
52 | | -[cols="1,2"] |
53 | | -|=== |
54 | | -| Platform | URL |
| 40 | +Traditional journalism conflates all four. Wayfinder separates and makes each navigable: |
55 | 41 |
|
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. |
61 | 138 |
|
62 | 139 | == License |
63 | 140 |
|
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 |
65 | 148 |
|
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 |
67 | 154 |
|
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) |
69 | 161 |
|
70 | | -See link:CONTRIBUTING.adoc[CONTRIBUTING.adoc]. |
| 162 | +--- |
71 | 163 |
|
72 | | -== Metadata |
| 164 | +*Version*: 0.1.0-alpha |
| 165 | +*Last Updated*: 2025-11-23 |
| 166 | +*Status*: Pre-release conceptual design |
73 | 167 |
|
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