Skip to content

Commit f377f40

Browse files
Jonathan D.A. Jewellclaude
andcommitted
fix: update CITATIONS and ROADMAP with Wayfinder project details
Corrected outdated template content to reflect actual project: 1. CITATIONS.adoc: - Author: "Hyper Polymath" → "Jonathan D.A. Jewell" - Title: "im-docs" → "Wayfinder: Epistemic Infrastructure for Journalism" - License: AGPL-3.0-or-later → PMPL-1.0-or-later - Updated all citation formats (BibTeX, Harvard, OSCOLA, MLA, APA 7) 2. ROADMAP.adoc: - Replaced generic template with actual Wayfinder roadmap - Added completed milestones (v0.1.0-alpha framework) - Detailed 4-week immediate plan (Level 1 materials, beta testing) - Phase 1-3 architecture (Prototype, Custom Platform, Ecosystem) - Documented open questions and long-term vision - Aligned with CHANGELOG.adoc development history Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent ce318f0 commit f377f40

2 files changed

Lines changed: 149 additions & 22 deletions

File tree

ROADMAP.adoc

Lines changed: 140 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,149 @@
11
// SPDX-License-Identifier: PMPL-1.0-or-later
2-
= Im Docs Roadmap
2+
= Wayfinder Roadmap
33

44
== Current Status
55

6-
Initial development phase.
6+
**Phase:** Proof-of-Concept Development
77

8-
== Milestones
8+
**Version:** 0.1.0-alpha (Released 2025-11-23)
99

10-
=== v0.1.0 - Foundation
11-
* [ ] Core functionality
12-
* [ ] Basic documentation
13-
* [ ] CI/CD pipeline
10+
**Completed:**
11+
* ✅ Conceptual framework (PROMPT, boundary objects, heutagogic design)
12+
* ✅ Four-level capability pathway design
13+
* ✅ Cognitive science integration
14+
* ✅ SWOT analysis
15+
* ✅ Technical architecture planning
16+
* ✅ Comprehensive documentation (README, claude.md, CHANGELOG)
1417

15-
=== v1.0.0 - Stable Release
16-
* [ ] Full feature set
17-
* [ ] Comprehensive tests
18-
* [ ] Production ready
18+
**In Progress:**
19+
* 🔄 Level 1 materials development
20+
* 🔄 Evidence mapping templates
21+
* 🔄 First example investigation
1922

20-
== Future Directions
23+
== Immediate Milestones (Weeks 1-4)
2124

22-
_To be determined based on community feedback._
25+
=== Week 1: Materials & Templates
26+
* [ ] Document Level 1 pathway in detail
27+
* [ ] Create evidence mapping template
28+
* [ ] Build PROMPT framework worksheets
29+
* [ ] Complete one example investigation
30+
31+
=== Week 2: Initial Feedback
32+
* [ ] Share with 3 journalist friends
33+
* [ ] Collect feedback on Level 1 materials
34+
* [ ] Iterate based on real-world use
35+
36+
=== Week 3: Public Launch
37+
* [ ] Build simple website (GitLab Pages)
38+
* [ ] Publish documentation
39+
* [ ] Open for beta tester applications
40+
41+
=== Week 4: Beta Testing Begins
42+
* [ ] Onboard first 5-10 participants
43+
* [ ] Support Level 1 completion
44+
* [ ] Track learnings and issues
45+
46+
== Phase 1: Prototype (Months 1-3)
47+
48+
=== Platform (Q1 2026)
49+
* [ ] Choose prototyping tool (Obsidian/TiddlyWiki/Notion)
50+
* [ ] Build Level 1 interactive templates
51+
* [ ] Create 2-3 example investigations
52+
* [ ] Test with 10-20 journalists
53+
54+
=== Learning Materials
55+
* [ ] Complete Level 1 materials
56+
* [ ] Draft Level 2A materials
57+
* [ ] Draft Level 2B materials
58+
* [ ] Create facilitator guides
59+
60+
=== Community
61+
* [ ] Recruit academic partners (journalism schools)
62+
* [ ] Connect with i-Docs practitioners
63+
* [ ] Engage National Union of Journalists (NUJ)
64+
* [ ] Apply for funding (Knight Foundation, Omidyar Network)
65+
66+
== Phase 2: Custom Platform (Months 3-9)
67+
68+
=== Technical Architecture
69+
* [ ] SvelteKit + PostgreSQL + Graph Database
70+
* [ ] PROMPT scoring system
71+
* [ ] Evidence linking and annotation
72+
* [ ] Multi-perspectival navigation
73+
* [ ] Collaborative features
74+
75+
=== Features
76+
* [ ] Progressive disclosure UI
77+
* [ ] Meta-cognitive prompts
78+
* [ ] Navigation analytics
79+
* [ ] Transparent methodology layer
80+
* [ ] Mobile-first responsive design
81+
82+
=== Level 3 Launch
83+
* [ ] Knowledge Architect materials
84+
* [ ] Full investigation builder
85+
* [ ] First 5 interactive investigations produced
86+
* [ ] Academic research integration
87+
88+
== Phase 3: Ecosystem (Months 9-18)
89+
90+
=== Infrastructure
91+
* [ ] Level 4 materials (Infrastructure Builder)
92+
* [ ] Tool development frameworks
93+
* [ ] Teaching materials for trainers
94+
* [ ] Community governance model
95+
96+
=== Scale
97+
* [ ] 100+ journalists trained (Levels 1-3)
98+
* [ ] 10+ interactive investigations published
99+
* [ ] 3+ academic papers on methodology
100+
* [ ] Partnership with major news organizations
101+
102+
=== Research
103+
* [ ] Measure impact on comprehension
104+
* [ ] Measure impact on trust calibration
105+
* [ ] Measure impact on behavior change
106+
* [ ] Refine based on empirical evidence
107+
108+
== Long-Term Vision (18+ months)
109+
110+
=== Sustainability
111+
* [ ] Business model established
112+
* [ ] Grant funding secured
113+
* [ ] Self-sustaining community
114+
* [ ] Open source contributor ecosystem
115+
116+
=== Integration
117+
* [ ] Curriculum adoption (journalism schools)
118+
* [ ] Industry standard for investigative journalism
119+
* [ ] Integration with existing CMS platforms
120+
* [ ] API for third-party tools
121+
122+
=== Impact
123+
* [ ] Measurable improvement in epistemic navigation
124+
* [ ] Reduced polarization in controversial topics
125+
* [ ] Restored trust in journalism process
126+
* [ ] Model for other knowledge domains
127+
128+
== Open Questions
129+
130+
**Technical:**
131+
* Which story for first full prototype?
132+
* Obsidian vs. TiddlyWiki vs. Notion for Phase 1?
133+
* How to balance flexibility vs. cognitive load?
134+
135+
**Community:**
136+
* How to recruit demoralized journalists effectively?
137+
* What incentives work for beta testers?
138+
* How to measure "success" meaningfully?
139+
140+
**Business:**
141+
* What's the sustainable revenue model?
142+
* How to avoid capture by existing power structures?
143+
* Can this scale without losing epistemic integrity?
144+
145+
== See Also
146+
147+
* link:../CHANGELOG.adoc[CHANGELOG] - Detailed development history
148+
* link:../README.adoc[README] - Project overview
149+
* link:../claude.md[claude.md] - Comprehensive technical documentation

docs/CITATIONS.adoc

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,34 @@
1-
= im-docs - Citation Guide
1+
= Wayfinder - Citation Guide
22
:toc:
33

44
== BibTeX
55

66
[source,bibtex]
77
----
8-
@software{im-docs_2025,
9-
author = {Polymath, Hyper},
10-
title = {im-docs},
8+
@software{wayfinder_2025,
9+
author = {Jewell, Jonathan D.A.},
10+
title = {Wayfinder: Epistemic Infrastructure for Journalism},
1111
year = {2025},
1212
url = {https://github.com/hyperpolymath/im-docs},
13-
license = {AGPL-3.0-or-later}
13+
license = {PMPL-1.0-or-later}
1414
}
1515
----
1616

1717
== Harvard Style
1818

19-
Polymath, H. (2025) _im-docs_ [Computer software]. Available at: https://github.com/hyperpolymath/im-docs
19+
Jewell, J.D.A. (2025) _Wayfinder: Epistemic Infrastructure for Journalism_ [Computer software]. Available at: https://github.com/hyperpolymath/im-docs
2020

2121
== OSCOLA
2222

23-
Hyper Polymath, 'im-docs' (2025) <https://github.com/hyperpolymath/im-docs>
23+
Jonathan D.A. Jewell, 'Wayfinder: Epistemic Infrastructure for Journalism' (2025) <https://github.com/hyperpolymath/im-docs>
2424

2525
== MLA
2626

27-
Polymath, Hyper. "im-docs." 2025, github.com/hyperpolymath/im-docs.
27+
Jewell, Jonathan D.A. "Wayfinder: Epistemic Infrastructure for Journalism." 2025, github.com/hyperpolymath/im-docs.
2828

2929
== APA 7
3030

31-
Polymath, H. (2025). _im-docs_ [Computer software]. GitHub. https://github.com/hyperpolymath/im-docs
31+
Jewell, J.D.A. (2025). _Wayfinder: Epistemic Infrastructure for Journalism_ [Computer software]. GitHub. https://github.com/hyperpolymath/im-docs
3232

3333
== See Also
3434

0 commit comments

Comments
 (0)