## Summary - Introduce a standalone Python roadmap validator with a CLI entry point, modular validation pipeline, and GitHub Actions wiring so roadmap content can be linted locally and in CI. - Provide reusable validation primitives for path resolution, front-matter parsing, identity checks, task parsing, catalog enforcement, and template adherence. - Document usage, configuration, and workflow behaviour to make the validator approachable for contributors. ## Validator Details - **Core tooling** - Added the `tools/roadmap_validator/` package with `validate.py` (CLI), `validator.py` (orchestration), and helper modules (`tasks.py`, `identity.py`, `paths.py`, `constants.py`, `issues.py`). - CLI supports directory/file targets, skips default filenames, emits GitHub annotations, and integrates optional substring filtering - README explains features, environment variables, and development guidance. - **Catalog and template enforcement** - `catalog.py` verifies each allowed content unit has `index.md` and `preview.md`, confirms roadmap entries appear under the proper quarter/area, and flags stale or missing links. - `templates.py` enforces template basics: front matter completeness, `## Description` ordering/content, template placeholder cleanup, and task section detection. - **Task validation** - `tasks.py` checks required metadata (`owner`, `status`, `start-date`, `end-date`), date formats, populated descriptions/deliverables, TODO markers, tangible deliverable heuristics, and `fully-qualified-name` prefixes. - **Workflow integration** - `.github/workflows/roadmap-validator.yml` runs the validator on pushes and manual dispatch, installs dependencies, scopes validation to changed Markdown, and surfaces findings via GitHub annotations. ## Existing Roadmap Updates - Normalised 2025q4 commitments across Web, DST, QA, SC, and other units by filling in missing descriptions, deliverables, schedule notes, recurring task statuses, and maintenance tasks. - Added tasks where absent, removed remaining template placeholders, aligned fully qualified names, and ensured roadmap files conform to the new validator checks. ## Testing ```bash python tools/roadmap_validator/validate.py *2025q4* ``` CI: `Roadmap Validator` workflow runs automatically on pushes/dispatch. --------- Co-authored-by: kaiserd <1684595+kaiserd@users.noreply.github.com>
10 KiB
title, tags, draft, description
| title | tags | draft | description | |||
|---|---|---|---|---|---|---|
| Logos Website |
|
false | Development of a comprehensive Logos website showcasing the complete technology stack with optimal user journey design, dual-experience architecture for developers and non-developers, and integrated community features that prioritize bringing people together through multiple engagement options. |
vac:web:ift:2025q4-logos-website
Description
This commitment involves developing a comprehensive Logos website that serves as the central hub for the volunteer-driven, open source community building strategy. The website will showcase the complete Logos technology stack while being built around carefully defined optimal user flows for primary and secondary users, with a core focus on bringing people together and providing multiple pathways for contribution that align with privacy principles and user preferences.
The Logos website will support the volunteer-driven community building strategy by:
- Technology Stack Showcase: Presenting the complete Logos technology stack and its capabilities to users and developers
- Optimal User Journey Design: Creating carefully defined user flows that highlight the single most important action for each user profile
- Community Convergence: Prioritizing bringing people together through multiple engagement pathways
- Developer Activation: Providing accessible entry points for external developers to contribute to the Logos technology stack
- Flexible Contribution Options: Providing diverse ways to contribute that respect privacy preferences and user comfort levels
- Personalized Onboarding: Ttraining, educational materials, and mentorship opportunities
- Dual-Pathway Architecture: Implementing "Learn" and "Contribute" high-level approaches that segment into specific user journeys
Key Features:
Logos Technology Stack Showcase
- Complete Stack Overview: Comprehensive presentation of all Logos protocols and technologies
- Technical Capabilities: Detailed explanation of what the Logos stack can do and how it works
- Integration Examples: Real-world use cases and implementation examples
- Developer Resources: Technical documentation and development guides for the stack
Dual-Pathway User Architecture
- Learn Pathway: Educational content, documentation, and knowledge resources about the Logos technology stack
- Contribute Pathway: Action-oriented tools and contribution opportunities for the Logos ecosystem
- Segmented User Journeys: Each pathway leads to pages that segment users by profile and needs
- Single Action Focus: Highlighting the most important action for each user profile
Developer User Journey
- Start Building: Direct access to Logos technology stack documentation and development resources
- Learn More: Comprehensive documentation and educational materials about Logos protocols
- Contribute: Streamlined contribution pathways and project discovery for the Logos ecosystem
- Apply for Grants: Grant application workflow and funding opportunities for Logos development
- Join Community: Multiple community options (Status Community, events, etc.)
Non-Developer User Journey
- Join Community: Status Community and alternative engagement platforms for the Logos movement
- Become a Member: Streamlined membership and onboarding flow to the Logos ecosystem
- Schedule Intro Calls: Personal connection and mentorship opportunities about Logos technology
- Event Participation: Local events, Circles, and CC attendance tracking for Logos community
- Online Engagement: Online calendar and virtual event participation in Logos activities
- Campaign Support: Campaign planner and advocacy tools for the Logos movement
- Get Training: Mentorship programs and educational resources about Logos technology
- Write Proposals: Logos contribute integration for non-technical contributions to the ecosystem
Privacy-Aligned Community Options
- Multiple Platform Support: Alternatives that respect privacy preferences
- Flexible Communication: Various ways to engage and contribute based on comfort levels
- Personal Connection
- Event-Based Engagement: Local and online events as community building tools
Design & Technical Features
- Experimental UI Elements: Implementing innovative design patterns and cutting-edge user interface components
- Hamburger Menu Innovation: Redesigning navigation with particular attention to mobile usability and user experience
- Mobile Responsiveness: Ensuring optimal performance and usability across all device sizes
- Brand Guidelines Compliance: Maintaining strict adherence to Logos brand standards and visual identity
- Cross-Functional Collaboration: Working with multiple stakeholders to ensure comprehensive design input
- Revision Process: Implementing a structured 3-cycle revision process for iterative improvement
Alignment with IFT Narratives:
- Digital Liberties: Creating web experiences that embody the principles of user sovereignty and digital freedom
- Community Co-creation: Building platforms that enable community engagement and participation
- Accessibility: Ensuring the website is accessible to users of all abilities and technical backgrounds
- Brand Coherence: Maintaining consistent messaging around IFT's mission of defending digital rights
Task List
Layout
- fully qualified name:
vac:web:ift:2025q4-logos-website:layout - owner: jinhojang6
- status: in progress (50%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
Finalize the responsive site layout, navigation structure, and page templates for the refreshed Logos web experience.
Deliverables
- PRs/Issues/Docs/Reports
Components
- fully qualified name:
vac:web:ift:2025q4-logos-website:layout - owner: jinhojang6
- status: in progress (50%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
Build and document the reusable UI component library that powers the new Logos website.
Deliverables
- PRs/Issues/Docs/Reports
Copyright
- fully qualified name:
vac:web:ift:2025q4-logos-website:layout - owner: 0xbathang
- status: in progress (50%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
Update copyright, legal disclosures, and footer messaging to align with the latest Logos positioning.
Deliverables
- PRs/Issues/Docs/Reports
Internationalization
- fully qualified name:
vac:web:ift:2025q4-logos-website:layout - owner: jinhojang6
- status: in progress (50%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
Implement the translation workflow and locale switching needed for a multilingual Logos site launch.
Deliverables
- PRs/Issues/Docs/Reports
SEO
- fully qualified name:
vac:web:ift:2025q4-logos-website:seo - owner: jinhojang6
- status: in progress (50%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
Optimize metadata, structured data, and performance budgets to improve discovery of the new site.
Deliverables
- PRs/Issues/Docs/Reports
Documentation
- fully qualified name:
vac:web:ift:2025q4-logos-website:documentation - owner: jinhojang6
- status: in progress (20%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
Create implementation notes and content authoring guides so teams can maintain the website after launch.
Deliverables
- PRs/Issues/Docs/Reports
Circles map
- fully qualified name:
vac:web:ift:2025q4-logos-website:circles-map - owner: jinhojang6
- status: not started
- start-date: 2025/10/20
- end-date: 2025/11/14
Description
Prototype an interactive map that visualizes Logos circles and makes it easy to discover active groups.
Deliverables
- PRs/Issues/Docs/Reports
Spaces Calendar
- fully qualified name:
vac:web:ift:2025q4-logos-website:spaces-calendar - owner: jinhojang6
- status: not started
- start-date: 2025/10/20
- end-date: 2025/11/14
Description
Embed an events calendar that aggregates upcoming Spaces sessions and community gatherings.
Deliverables
- PRs/Issues/Docs/Reports
Data visualization
- fully qualified name:
vac:web:ift:2025q4-logos-website:data-visualization - owner: jackewing
- status: in progress (50%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
Design and implement the data visualization modules that communicate Logos impact metrics.
Deliverables
- PRs/Issues/Docs/Reports
CTAs
- fully qualified name:
vac:web:ift:2025q4-logos-website:ctas - owner: jinhojang6
- status: in progress (20%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
- Newsletter
- Events
- Join
- Download
- Learn
- Apply
- Build
- Roadmap
Deliverables
- PRs/Issues/Docs/Reports
Blog (Press Engine)
- fully qualified name:
vac:web:ift:2025q4-logos-website:blog - owner: JulesFiliot
- status: in progress (60%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
Stand up the press engine blog system with publishing workflow, tagging, and archive views.
Deliverables
- PRs/Issues/Docs/Reports
Search
- fully qualified name:
vac:web:ift:2025q4-logos-website:search - owner: JulesFiliot
- status: not started
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
Implement site-wide search that surfaces content across product pages, docs, and community resources.
Deliverables
- PRs/Issues/Docs/Reports
External references
- fully qualified name:
vac:web:ift:2025q4-logos-website:external-references - owner: jinhojang6
- status: not started
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
- from free.technology
Deliverables
- PRs/Issues/Docs/Reports
Social Proof
- fully qualified name:
vac:web:ift:2025q4-logos-website:social-proof - owner: JulesFiliot
- status: in progress (70%)
- start-date: 2025/05/09
- end-date: 2025/10/31
Description
- Commits
- Contributors
- Members
Deliverables
https://www.figma.com/design/hyehOA8iMTDiazHy4IDL6D/Logos-2?node-id=46-2287&p=f&t=fxzLuvGuIGzW0LaG-0 https://github.com/acid-info/logos-co https://logos-co-rvlb.vercel.app https://miro.com/app/board/uXjVI--PDlE=/?moveToWidget=3458764639386405845&cot=14 https://app.clickup.com/t/86b4pj648 https://www.notion.so/Logos-Movement-Strategy-H2-2025-WIP-2298f96fb65c8025a528cde1ad846f1d#2298f96fb65c8084aac0d78dc4abddee https://www.notion.so/Logos-Movement-Strategy-H1-2025-1ae8f96fb65c80c3b390c72702245ab0 https://docs.google.com/document/d/1GXBOkPx_4p8A967SLungZAe7_lUTzobTb_BHZheUgQ4/edit?usp=sharing