Product Wiki
The Product Wiki is your central documentation hub for product specifications, decisions, and knowledge.
Overview
The Product Wiki serves as:
- Living documentation — Always up-to-date product specs
- Decision log — Record why choices were made
- Team alignment — Single source of truth
- Onboarding resource — Help new team members get up to speed
Structure
The Product Wiki uses the same Notion-style editor as Research Notes, but is specifically designed for product documentation.
Suggested Organization
📚 Product Wiki
├── 🎯 Product Overview
│ ├── Vision & Mission
│ ├── Target Audience
│ └── Value Proposition
├── 🏗️ Architecture
│ ├── System Overview
│ ├── Technical Stack
│ └── Integrations
├── 📋 Specifications
│ ├── Feature Specs
│ ├── API Documentation
│ └── Data Models
├── 📝 Decisions
│ ├── Architecture Decisions
│ ├── Product Decisions
│ └── Design Decisions
└── 📖 Guides
├── User Guides
├── Admin Guides
└── Developer GuidesCreating Wiki Pages
New Page
- Navigate to Product → Product Wiki
- Click + New Page in the sidebar
- Enter a title
- Start documenting
Templates
Use templates for common page types:
Feature Specification Template
markdown
# Feature Name
## Overview
Brief description of the feature
## User Stories
- As a [user], I want to [action] so that [benefit]
## Requirements
### Functional Requirements
- [ ] Requirement 1
- [ ] Requirement 2
### Non-Functional Requirements
- Performance: ...
- Security: ...
## Design
[Link to designs or embed images]
## Technical Notes
Implementation considerations
## Open Questions
- Question 1?
- Question 2?Decision Record Template
markdown
# Decision: [Title]
## Status
Proposed / Accepted / Deprecated / Superseded
## Context
What is the issue we're addressing?
## Decision
What did we decide?
## Consequences
What are the implications?
## Alternatives Considered
What else did we consider?AI Assistance
Generate Documentation
Click the AI Assist button to:
- Generate initial documentation from feature ideas
- Expand bullet points into full descriptions
- Create user stories from requirements
- Suggest missing sections
Context-Aware Help
When you ask Molley for help with wiki content, it knows:
- Your product's purpose and audience
- Existing features and their status
- Related research and decisions
- Your company's communication style
Example Prompts
- "Write a feature specification for [feature name]"
- "Create user stories for this requirement"
- "Suggest what's missing from this documentation"
- "Improve the clarity of this section"
Linking Content
Link to Features
Reference features directly:
- Type
[[to search - Select a feature from Feature Ideas
- The link shows current status
Link to Research
Connect documentation to research:
- Link to Research Notes for context
- Reference Knowledge Notebooks
- Include Data Synthesis findings
Link to Requirements
Show the breakdown:
- Link to specific requirements
- Display requirement status
- Track completion
Collaboration
Comments
Add comments to discuss content:
- Select text
- Click the comment icon
- Add your comment
- Team members are notified
Version History
Track changes over time:
- Click History in the page menu
- View previous versions
- Restore if needed
Assignments
Assign pages for review:
- Click Assign in the page menu
- Select team members
- They receive a notification
Best Practices
1. Keep It Current
Documentation is only useful if it's accurate:
- Update specs when features change
- Archive outdated content
- Review regularly
2. Write for Your Audience
Consider who will read this:
- Technical docs for developers
- User guides for customers
- Overview docs for stakeholders
3. Use Visuals
Include diagrams and images:
- Architecture diagrams
- User flow charts
- Screenshots
- Wireframes
4. Link Liberally
Connect related content:
- Cross-reference between pages
- Link to external resources
- Reference features and requirements
5. Document Decisions
Record the "why" not just the "what":
- Why was this approach chosen?
- What alternatives were considered?
- What constraints influenced the decision?
Next Steps
- Feature Ideas — Capture new ideas
- Feature Kanban — Track feature progress
- Requirements — Break down features
