> ## Documentation Index
> Fetch the complete documentation index at: https://docs.radicalwhale.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Pages
> Rich AI-powered notebooks for workspace and record documentation
## What are Pages?
Pages are rich-text notebooks with powerful editing and AI generation capabilities for creating, organizing, and collaborating on documentation. Create workspace-level pages for general knowledge or attach to specific dataset records for contextual analysis.
## Core Concepts
**Workspace pages**: Shared documentation, project planning, meeting notes, templates, reference material accessible to all members.
**Record pages**: Context-specific documentation for individual dataset records with data analysis, research notes, case studies, and processing context.
**Rich text editor**: Built with Tiptap offering markdown support, formatting (bold, italic, headings, lists), code blocks, tables, images, links, task lists.
## Creating Pages
**Workspace pages**: Navigate to Pages → Create Page → Enter title and icon → Start writing → Auto-saves.
**Record pages**: Open dataset record → Pages tab → Create Page → Automatically linked → Access record context.
**Metadata**: Title, emoji/icon, status (draft/published/archived), tags, timestamps, author tracking.
**Organization**: Search, filtering by status/tags/author, sorting, favorites, breadcrumbs.
## AI Content Generation
**Slash commands**: Type `/` for AI generation (`/ai`), headings (`/h1`, `/h2`, `/h3`), lists (`/bullet`, `/numbered`, `/todo`), code blocks, tables, images.
**AI assistant**: Select agent → Attach reference pages (optional) → Write prompt → Generate → Real-time streaming → Tool usage visibility → Markdown output.
**Page context**: Attach workspace or dataset pages as reference material for templates, style guides, source material, format replication.
## Editor Features
**Text formatting**: Bold, italic, strikethrough, inline code, links, headings (H1-H6).
**Block content**: Syntax-highlighted code blocks, tables with row/column operations, task lists with checkboxes, blockquotes, horizontal rules.
**Interactive**: Drag and drop to reorder blocks, selection menus with formatting toolbar, table context menus.
## Record Page Context
**Automatic context**: Pages know parent record, access to field values, reference sibling pages, understanding of dataset structure.
**AI with record context**: AI receives record data automatically, can reference field values and evidence, generates content informed by record details.
**Multi-page records**: Create multiple pages per record for overview, analysis, research, notes, reports.
## Best Practices
**Organization**: Clear descriptive titles, consistent naming conventions, smart tagging by project/topic/purpose, status management (draft/published/archived).
**Content creation**: Structured writing with clear headings, use AI for initial drafts and expansion, reference existing pages for consistency, visual enhancement with emojis and formatting.
**Collaboration**: Create workspace pages for shared knowledge, document team processes, build templates, maintain up-to-date references.
## Page Context System
Attach pages as reference material when generating AI content:
**Uses**: Template replication (copy structure/style), information synthesis (combine sources), consistent voice (maintain style), knowledge reuse (build on existing docs).
**Examples**:
* Style guide application: Attach "Writing Style Guide" → Generate on-brand content
* Template-based: Attach "Q3 Report Template" → Create Q4 report with current data
* Multi-source analysis: Attach research notes → Synthesize into executive summary
## Common Use Cases
**Documentation**: Team wiki, project documentation, architecture decisions, post-mortems.
**Research**: Dataset analysis, competitive intelligence, market trends, findings documentation.
**Content creation**: Draft generation with AI, structured reports, consistent formatting, collaborative writing.
**Collaboration**: Meeting notes, brainstorming, strategic planning, action item tracking.
## Next Steps
Create workspace and record pages
Use AI to generate content
Master page context system
Learn about AI agents
## Core Concepts
### Workspace-Level Pages
Workspace pages serve as your team's knowledge hub:
* **Shared Documentation**: Create docs, wikis, and knowledge bases accessible to all workspace members
* **Project Planning**: Draft project plans, roadmaps, and strategic documents
* **Meeting Notes**: Capture discussions, decisions, and action items
* **Templates**: Build reusable templates for reports, analyses, and standard documents
* **Reference Material**: Store policies, procedures, and institutional knowledge
### Record-Level Pages
Record pages provide context-specific documentation:
* **Data Analysis**: Write detailed analysis for individual dataset records
* **Research Notes**: Document findings and insights for specific companies, people, or entities
* **Case Studies**: Create in-depth examination of particular records
* **Processing Context**: Explain data decisions and enrichment reasoning
* **Historical Documentation**: Track changes, updates, and evolution over time
### Rich Text Editor
Pages are built with Tiptap, a modern editor offering:
* **Markdown Support**: Write using familiar markdown syntax
* **Formatting Options**: Bold, italic, headings, lists, and more
* **Code Blocks**: Syntax-highlighted code with language selection
* **Tables**: Create structured data tables within your pages
* **Images**: Embed images directly in your documentation
* **Links**: Connect to external resources and other pages
* **Task Lists**: Interactive checkboxes for action items
* **Horizontal Rules**: Visual section dividers
## Creating and Managing Pages
### Page Creation
Creating a page is straightforward:
**Workspace Pages**
1. Navigate to the Pages section in your workspace sidebar
2. Click "Create Page" to start a new document
3. Enter a title and optional emoji icon
4. Start writing with the rich text editor
5. Save automatically as you type
**Record Pages**
1. Open any dataset record detail view
2. Navigate to the Pages tab
3. Click "Create Page" to add documentation
4. The page is automatically linked to that specific record
5. Access context from the parent dataset record
### Page Metadata
Every page includes:
* **Title**: Descriptive name for the page
* **Emoji/Icon**: Visual identifier using emojis or Lucide icons
* **Status**: Draft, published, or archived state
* **Tags**: Categorization labels for organization
* **Timestamps**: Creation and last updated information
* **Author**: Creator and contributor tracking
### Organization Features
Keep your pages organized:
* **Search**: Full-text search across all page content
* **Filtering**: Filter by status, tags, author, or creation date
* **Sorting**: Order by title, updated date, or creation date
* **Favorites**: Star important pages for quick access
* **Breadcrumbs**: Navigate page hierarchies and relationships
## AI-Powered Content Generation
### Inline AI Assistant
The most powerful feature of pages is the integrated AI assistant:
**Slash Commands**
Type `/` at the beginning of any line to access:
* **AI Generation**: `/ai` - Generate content using your workspace agents
* **Headings**: `/h1`, `/h2`, `/h3` - Create section headers
* **Lists**: `/bullet`, `/numbered`, `/todo` - Create various list types
* **Code**: `/code` - Insert code blocks with syntax highlighting
* **Tables**: `/table` - Insert structured data tables
* **Media**: `/image`, `/divider` - Add visual elements
**AI Content Generation**
When you invoke `/ai`, you get:
1. **Agent Selection**: Choose from your workspace agents
2. **Page Context**: Optionally attach reference pages for context
3. **Prompt Input**: Describe what content you want generated
4. **Real-time Streaming**: Watch as AI generates content live
5. **Tool Usage**: See when AI uses tools for research
6. **Markdown Output**: Content inserted as formatted markdown
### Reference Pages as Context
One of the most powerful features is attaching pages as context:
**How It Works**
* Select pages from your workspace to provide as reference material
* AI agents can access the full content of selected pages
* Use pages as templates, style guides, or information sources
* Combine multiple pages for comprehensive context
**Use Cases**
* **Template Copying**: Reference a well-formatted page to generate similar content
* **Style Consistency**: Attach your style guide for consistent voice and tone
* **Data Context**: Include pages with background information or research
* **Format Replication**: Use existing pages as structural templates
## Editor Features
### Text Formatting
Standard text formatting options:
* **Bold** and *italic* styling
* ~~Strikethrough~~ text
* `Inline code` formatting
* Links to external resources
* Headings from H1 to H6
### Block Content
Rich content blocks:
**Code Blocks**
```python theme={null}
# Syntax-highlighted code
def hello_world():
print("Hello from Radical Whale!")
```
**Tables**
| Feature | Description | Status |
| ------------- | ---------------- | ------ |
| Rich Text | Markdown editing | ✓ |
| AI Generation | Content creation | ✓ |
| Page Context | Reference pages | ✓ |
**Task Lists**
* [ ] Draft project proposal
* [x] Complete market research
* [ ] Review with team
### Interactive Elements
**Drag and Drop**
* Reorder content blocks by dragging
* Move paragraphs, lists, and sections
* Reorganize document structure easily
**Selection Menus**
* Text selection shows formatting toolbar
* Quick access to bold, italic, links, and code
* Table context menus for row/column operations
## Working with Record Pages
### Context Integration
Record pages have special capabilities:
**Automatic Context**
* Pages know which dataset record they belong to
* Access to all record field values
* Can reference sibling pages on the same record
* Understanding of parent dataset structure
**AI with Record Context**
When using AI on record pages:
* AI automatically receives record data as context
* Field values, evidence, and sources available
* Can generate content informed by record details
* Maintains consistency across related pages
### Multi-Page Records
Create multiple pages per record for different purposes:
* **Overview**: High-level summary and key findings
* **Analysis**: Deep-dive technical or business analysis
* **Research**: Detailed source documentation and references
* **Notes**: Ongoing observations and updates
* **Reports**: Formatted output documents
## Best Practices
### Page Organization
**Effective Naming**
* Use clear, descriptive titles that indicate content purpose
* Include dates for time-sensitive documentation
* Use consistent naming conventions across similar pages
* Consider hierarchical naming for related documents
**Smart Tagging**
* Tag pages by project, topic, or purpose
* Use tags for cross-cutting themes and categories
* Keep tag vocabulary consistent and manageable
* Review and consolidate tags periodically
**Status Management**
* Use "Draft" for work-in-progress content
* Mark "Published" for finalized, shared documentation
* "Archive" old or outdated pages for historical reference
* Review status regularly to keep workspace clean
### Content Creation
**Structured Writing**
* Start with clear headings and sections
* Use lists for easier scanning and reading
* Include relevant code examples and data
* Add links to external resources and references
**AI Collaboration**
* Write initial outlines manually for structure
* Use AI to expand on key points and details
* Reference existing pages for consistent style
* Review and edit AI-generated content
**Visual Enhancement**
* Use emojis and icons for visual identification
* Add horizontal rules to separate major sections
* Include tables for structured information
* Embed relevant images when helpful
### Collaboration Workflows
**Team Knowledge Sharing**
* Create workspace pages for shared knowledge
* Document team processes and procedures
* Build templates for common document types
* Maintain up-to-date reference materials
**Record Documentation**
* Add analysis pages to important dataset records
* Document research methodology and findings
* Track changes and updates over time
* Provide context for future team members
## Advanced Features
### Page Context System
The page context system is revolutionary for AI content generation:
**How to Use**
1. Type `/ai` in your editor
2. Select an AI agent
3. Click "Attach pages" in the AI prompt
4. Choose one or more reference pages
5. Write your prompt describing desired output
6. AI generates content informed by selected pages
**Context Benefits**
* **Template Replication**: Copy structure and style from existing pages
* **Information Synthesis**: Combine data from multiple sources
* **Consistent Voice**: Maintain writing style across documents
* **Knowledge Reuse**: Build on existing documentation
**Example Workflows**
**Style Guide Application**
```
Attached: "Company Writing Style Guide"
Prompt: "Write a product announcement following our style guide"
Result: Content that matches your established voice and format
```
**Template-Based Generation**
```
Attached: "Q3 Board Report Template"
Prompt: "Create Q4 board report with current metrics"
Result: Properly formatted report following your template
```
**Multi-Source Analysis**
```
Attached: "Market Research Notes", "Competitor Analysis"
Prompt: "Synthesize key insights into executive summary"
Result: Comprehensive summary drawing from both sources
```
### Version History
Track how your pages evolve:
* **Automatic Saves**: Content saved as you type
* **Revision Tracking**: See who made changes and when
* **Change History**: View what was added or modified
* **Rollback Capability**: Restore previous versions if needed
### Search and Discovery
Find information across all your pages:
* **Full-Text Search**: Search content, titles, and tags
* **Filter Combinations**: Narrow results by multiple criteria
* **Recent Pages**: Quick access to recently viewed or edited
* **Related Pages**: Discover connected documentation
## Common Use Cases
### Documentation and Knowledge Management
**Team Wiki**
* Create comprehensive documentation for products, processes, and procedures
* Build searchable knowledge base for common questions
* Maintain up-to-date reference materials and guides
* Onboard new team members with structured documentation
**Project Documentation**
* Write project proposals, plans, and specifications
* Document architecture decisions and technical designs
* Track project progress and milestones
* Create post-mortems and retrospective analyses
### Research and Analysis
**Dataset Analysis**
* Write detailed analysis for dataset records
* Document research methodology and sources
* Track insights and findings over time
* Create reports combining data and narrative
**Competitive Intelligence**
* Document competitor research and analysis
* Track market trends and industry developments
* Synthesize information from multiple sources
* Maintain current awareness on key topics
### Content Creation
**Draft Generation**
* Use AI to generate initial content drafts
* Reference existing pages as style templates
* Create consistent content across documents
* Speed up documentation processes
**Report Creation**
* Generate structured reports from data and analysis
* Use templates for consistent formatting
* Combine manual writing with AI assistance
* Export finalized reports for distribution
### Collaboration and Communication
**Meeting Notes**
* Document discussions, decisions, and action items
* Track follow-ups and responsibilities
* Share notes with team members
* Link to related projects and documentation
**Brainstorming**
* Capture ideas and creative thinking
* Organize thoughts with structured formatting
* Use AI to expand on initial concepts
* Collaborate on strategic planning
## Next Steps
Create workspace and record pages
Use AI to generate content
Master page context system
Learn about AI agents