open-notebook/docs/features/citations.md

# Citations & References

Open Notebook's citation system ensures research integrity and transparency by providing accurate source attribution for all AI-generated insights. This comprehensive guide covers how citations work throughout the platform and how to leverage them for academic and research workflows.

## Overview

The citation system in Open Notebook is built around the principle of **transparent and verifiable research**. Every AI-generated response includes proper source attribution, allowing you to trace claims back to their original sources. This system supports various academic and professional workflows while maintaining the highest standards of research integrity.

### Key Features

- **Automatic Source Attribution**: AI responses automatically include citations to source materials
- **Clickable Citation Links**: Direct access to original source content
- **Context-Aware Citations**: Citations adapt based on the content included in AI context
- **Multiple Citation Formats**: Support for various citation styles and formats
- **Cross-Platform Integration**: Citations work across chat, search, and note-taking features
- **Export Compatibility**: Citations are preserved in exported content

## How Citations Work in Open Notebook

### Automatic Citation Generation

Open Notebook automatically generates citations whenever AI models reference your source materials. The system:

1. **Tracks Source Usage**: Monitors which sources are referenced in AI responses
2. **Extracts Specific References**: Identifies exact quotes, paraphrases, and concept references
3. **Generates Attribution**: Creates proper citations with source identification
4. **Maintains Context**: Preserves the relationship between claims and sources

### Citation Components

Each citation in Open Notebook includes:

- **Source Identification**: Clear identification of the referenced document
- **Content Location**: Specific sections, pages, or chunks referenced
- **Link to Original**: Direct access to the full source material
- **Attribution Context**: How the source was used in the AI response

### Citation Accuracy

The system ensures citation accuracy through:

- **Source Verification**: Cross-referencing claims against original content
- **Context Matching**: Ensuring citations match the actual content used
- **Quote Precision**: Accurate representation of direct quotes and paraphrases
- **Relationship Tracking**: Maintaining the connection between insights and sources

## Using Citations in Chat

### Understanding Chat Citations

When you engage with the AI assistant in chat, citations appear automatically when sources are referenced:

```
AI: According to the research presented in "Machine Learning Fundamentals" [1], 
neural networks require careful hyperparameter tuning for optimal performance.

[1] Machine Learning Fundamentals - Section 3.2: Neural Network Training
```

### Requesting Better Citations

You can improve citation quality by:

**Asking for Specific References**:
- "Please provide the exact quote that supports this point"
- "Which page in the document contains this information?"
- "Can you cite the specific study mentioned?"

**Requesting Citation Formats**:
- "Please include page numbers for all references"
- "Can you provide APA-style citations for these sources?"
- "Include direct quotes with proper attribution"

### Verifying Citation Accuracy

Always verify citations by:

1. **Clicking Citation Links**: Access the original source content
2. **Cross-Checking Claims**: Compare AI statements with source material
3. **Context Verification**: Ensure citations are used appropriately
4. **Completeness Check**: Confirm important sources aren't missing

### Best Practices for Chat Citations

**For Research Conversations**:
- Ask for specific citations when making claims
- Request page numbers and section references
- Verify controversial or critical statements
- Save well-cited responses as notes

**For Academic Work**:
- Request formal citation formats
- Ask for multiple supporting sources
- Verify quote accuracy and context
- Maintain bibliography tracking

## Ask Feature and Citations

### How Ask Feature Citations Work

The Ask feature provides comprehensive citations through a multi-step process:

1. **Query Strategy**: AI determines what information to search for
2. **Source Search**: Vector search identifies relevant content
3. **Individual Analysis**: Each source is analyzed separately
4. **Citation Generation**: Proper attribution is created for each source
5. **Final Synthesis**: All citations are compiled in the final answer

### Citation Quality in Ask Responses

Ask feature citations include:

- **Comprehensive Source Coverage**: References to all relevant sources
- **Specific Content Attribution**: Page numbers and section references
- **Direct Quote Integration**: Properly attributed quotes and paraphrases
- **Source Link Access**: Direct links to original documents

### Best Practices for Ask Citations

**Question Formulation**:
- Ask specific questions that require citation
- Request evidence-based responses
- Specify citation format requirements
- Ask for supporting documentation

**Result Verification**:
- Review all cited sources
- Verify quote accuracy
- Check for missing important sources
- Confirm citation relevance

## Citation Formatting and Display

### Display Formats

Citations appear in various formats throughout Open Notebook:

**Inline Citations**:
```
The study demonstrates significant improvement [1] in performance metrics.
```

**Reference Lists**:
```
References:
[1] Smith, J. (2023). "Performance Optimization in Machine Learning." 
    Journal of AI Research, 45(3), 123-145.
```

**Contextual Citations**:
```
Source: "Machine Learning Fundamentals" - Chapter 3, Page 47
"Neural networks require careful hyperparameter tuning..."
```

### Citation Styles

Open Notebook supports multiple citation approaches:

- **Numbered References**: [1], [2], [3] format
- **Author-Date**: (Smith, 2023) format
- **Footnote Style**: Superscript references
- **Custom Formats**: Configurable citation styles

### Interactive Citation Features

**Clickable Links**:
- Click any citation to view the original source
- Hover for quick preview of referenced content
- Direct navigation to specific sections

**Citation Tooltips**:
- Hover over citations for source information
- Quick access to document metadata
- Preview of referenced content

## Source Attribution and Accuracy

### Source Tracking

Open Notebook maintains detailed source attribution through:

**Metadata Preservation**:
- Document titles and authors
- Creation and modification dates
- Source URLs and file locations
- Document type and format information

**Content Mapping**:
- Specific sections and pages referenced
- Embedded chunk identification
- Context window tracking
- Quote and paraphrase location

### Accuracy Verification

The system ensures citation accuracy through:

**Content Verification**:
- Cross-referencing AI claims with source material
- Verifying quote accuracy and context
- Checking for misattribution or misrepresentation
- Ensuring complete source coverage

**Quality Assurance**:
- Regular citation accuracy checks
- Source link verification
- Content freshness monitoring
- Attribution completeness review

### Attribution Standards

Open Notebook follows research integrity standards:

- **Complete Attribution**: All sources properly credited
- **Accurate Representation**: Faithful reproduction of source claims
- **Context Preservation**: Maintaining original meaning and intent
- **Transparency**: Clear indication of AI-generated vs. source content

## Integration with Notes and Search

### Citations in Notes

When saving AI responses as notes, citations are preserved:

**Note Citation Features**:
- Automatic citation preservation
- Source link maintenance
- Reference list generation
- Bibliography compilation

**Citation Management in Notes**:
- Edit and format citations
- Add additional source information
- Organize citations by topic
- Create reference collections

### Search Result Citations

Search results include proper attribution:

**Search Citation Elements**:
- Source identification
- Content location indicators
- Relevance scoring
- Direct source access

**Citation in Search Results**:
- Highlighted relevant passages
- Source metadata display
- Link to full document
- Context preservation

### Cross-Platform Citation Consistency

Citations remain consistent across:

- **Chat Conversations**: Proper attribution in AI responses
- **Search Results**: Source identification and linking
- **Note Collections**: Preserved citations in saved content
- **Export Formats**: Citation maintenance in output

## Advanced Citation Features

### Custom Citation Formats

Create custom citation styles for specific needs:

**Academic Formats**:
- APA, MLA, Chicago, Harvard styles
- Journal-specific formats
- Institution requirements
- Custom academic standards

**Professional Formats**:
- Industry-specific citation styles
- Report and documentation formats
- Legal citation standards
- Technical documentation styles

### Citation Analytics

Track citation usage across your research:

**Citation Metrics**:
- Most frequently cited sources
- Citation patterns and trends
- Source utilization analysis
- Research coverage gaps

**Source Performance**:
- Citation frequency per source
- Content utilization rates
- Source effectiveness metrics
- Research impact assessment

### Bulk Citation Management

Manage citations across multiple documents:

**Citation Operations**:
- Bulk citation format updates
- Source information synchronization
- Citation style consistency
- Reference list generation

**Bibliography Management**:
- Automatic bibliography creation
- Citation deduplication
- Source organization
- Reference verification

## Best Practices for Research Integrity

### Academic Research Standards

**Citation Requirements**:
- Cite all sources used in AI conversations
- Verify quote accuracy and context
- Include page numbers and specific references
- Maintain complete bibliography records

**Plagiarism Prevention**:
- Always attribute AI-generated insights
- Distinguish between source content and AI analysis
- Verify all claims against original sources
- Maintain transparent research practices

### Professional Research Practices

**Documentation Standards**:
- Maintain detailed citation records
- Document AI assistance in research
- Preserve source accessibility
- Ensure citation completeness

**Quality Assurance**:
- Regular citation accuracy checks
- Source verification procedures
- Peer review of citation practices
- Continuous improvement processes

### Collaboration and Sharing

**Team Research**:
- Share citation standards across teams
- Maintain consistent citation practices
- Collaborate on source verification
- Establish citation quality protocols

**Knowledge Sharing**:
- Document citation best practices
- Share effective citation strategies
- Contribute to citation improvement
- Maintain community standards

## Export Options with Citations

### Citation Preservation in Exports

All export formats maintain citation integrity:

**Export Formats**:
- Markdown with citation links
- PDF with clickable references
- HTML with interactive citations
- Plain text with reference lists

**Citation Elements Preserved**:
- Source attribution
- Reference links
- Bibliography information
- Citation formatting

### Export Best Practices

**Before Exporting**:
- Verify all citations are accurate
- Check source link functionality
- Ensure bibliography completeness
- Review citation formatting

**Export Configuration**:
- Choose appropriate citation format
- Configure link behavior
- Set bibliography preferences
- Optimize for target audience

### Integration with External Tools

**Citation Managers**:
- Export citations to Zotero, Mendeley
- BibTeX and EndNote compatibility
- Reference manager integration
- Citation synchronization

**Document Platforms**:
- Word processor integration
- LaTeX citation support
- Academic publishing formats
- Collaboration tool compatibility

## Troubleshooting Citation Issues

### Common Citation Problems

**Missing Citations**:
- Check source context configuration
- Verify AI model has access to sources
- Ensure sources are properly processed
- Review context inclusion settings

**Incorrect Citations**:
- Verify source content accuracy
- Check for processing errors
- Review AI model interpretation
- Validate citation formatting

**Broken Citation Links**:
- Verify source accessibility
- Check for moved or deleted files
- Update source URLs
- Refresh source processing

### Citation Quality Improvement

**Enhancing Citation Accuracy**:
- Provide specific context to AI
- Request detailed source references
- Verify claims against sources
- Ask for supporting evidence

**Improving Citation Completeness**:
- Include all relevant sources in context
- Request comprehensive source coverage
- Ask for missing source identification
- Verify citation thoroughness

## Future Enhancements

### Planned Citation Features

**Enhanced Citation Formats**:
- Additional academic citation styles
- Custom format creation tools
- Citation style templates
- Format validation tools

**Advanced Attribution**:
- Granular content attribution
- Multi-source synthesis tracking
- Citation relationship mapping
- Source influence analysis

**Integration Improvements**:
- Enhanced export capabilities
- Better citation manager integration
- Improved collaboration features
- Advanced citation analytics

### Community Contributions

**User Feedback**:
- Citation accuracy reporting
- Format suggestion system
- Best practice sharing
- Feature request channels

**Collaborative Development**:
- Citation standard contributions
- Format template sharing
- Quality improvement initiatives
- Community citation guidelines

## Conclusion

Open Notebook's citation system provides a robust foundation for maintaining research integrity across all your knowledge work. By automatically generating accurate citations, providing transparent source attribution, and maintaining citation quality across all features, the system supports both academic and professional research workflows.

The key to effective citation use in Open Notebook is understanding how citations flow through the system - from source processing through AI analysis to final export. By following best practices for citation verification, maintaining source quality, and leveraging the system's advanced features, you can ensure that your research maintains the highest standards of academic and professional integrity.

Remember that citations in Open Notebook are not just reference links - they are the foundation of transparent, verifiable, and trustworthy research. Use them wisely to build upon existing knowledge while maintaining complete attribution to original sources.

Whether you're conducting academic research, professional analysis, or collaborative knowledge building, Open Notebook's citation system provides the tools you need to maintain research integrity while leveraging the power of AI-assisted analysis.