open-notebook/docs/3-USER-GUIDE/working-with-notes.md

Working with Notes - Capturing and Organizing Insights

Notes are your processed knowledge. This guide covers how to create, organize, and use them effectively.

---

What Are Notes?

Notes are your research output — the insights you capture from analyzing sources. They can be:

• Manual — You write them yourself
• AI-Generated — From Chat responses, Ask results, or Transformations
• Hybrid — AI insight + your edits and additions

Unlike sources (which never change), notes are mutable — you edit, refine, and organize them.

---

Quick-Start: Create Your First Note

Method 1: Manual Note (Write Yourself)

1. In your notebook, go to "Notes" section
2. Click "Create New Note"
3. Give it a title: "Key insights from source X"
4. Write your content (markdown supported)
5. Click "Save"
6. Done! Note appears in your notebook

Method 2: Save from Chat

1. Have a Chat conversation
2. Get a good response from AI
3. Click "Save as Note" button under response
4. Give the note a title
5. Add any additional context
6. Click "Save"
7. Done! Note appears in your notebook

Method 3: Apply Transformation

1. Go to "Transformations"
2. Select a template (or create custom)
3. Click "Apply to sources"
4. Select which sources to transform
5. Wait for processing
6. New notes automatically appear
7. Done! Each source produces one note

---

Creating Manual Notes

Basic Structure

Title: "What you're capturing"
       (Make it descriptive)

Content:
  - Main points
  - Your analysis
  - Questions raised
  - Next steps

Metadata:
  - Tags: How to categorize
  - Related sources: Which documents influenced this
  - Date: Auto-added when created

Markdown Support

You can format notes with markdown:

# Heading
## Subheading
### Sub-subheading

**Bold text** for emphasis
*Italic text* for secondary emphasis

- Bullet lists
- Like this

1. Numbered lists
2. Like this

> Quotes and important callouts

[Links work](https://example.com)

Example Note Structure

# Key Findings from "AI Safety Paper 2025"

## Main Argument
The paper argues that X approach is better than Y because...

## Methodology
The authors use [methodology] to test this hypothesis.

## Key Results
- Result 1: [specific finding with citation]
- Result 2: [specific finding with citation]
- Result 3: [specific finding with citation]

## Gaps & Limitations
1. The paper assumes X, which might not hold in Y scenario
2. Limited to Z population/domain
3. Future work needed on A, B, C

## My Thoughts
- This connects to previous research on...
- Potential application in...

## Next Steps
- [ ] Read the referenced paper on X
- [ ] Find similar studies on Y
- [ ] Discuss implications with team

---

AI-Generated Notes: Three Sources

1. Save from Chat

Workflow:
  Chat → Good response → "Save as Note"
         → Edit if needed → Save

When to use:
  - AI response answers your question well
  - You want to keep the answer for reference
  - You're building a knowledge base from conversations

Quality:
  - Quality = quality of your Chat question
  - Better context = better responses = better notes
  - Ask specific questions for useful notes

2. Save from Ask

Workflow:
  Ask → Comprehensive answer → "Save as Note"
      → Edit if needed → Save

When to use:
  - You need a one-time comprehensive answer
  - You want to save the synthesized result
  - Building a knowledge base of comprehensive answers

Quality:
  - System automatically found relevant sources
  - Results already have citations
  - Often higher quality than Chat (more thorough)

3. Transformations (Batch Processing)

Workflow:
  Define transformation → Apply to sources → Notes auto-created
                      → Review & edit → Organize

Example Transformation:
  Template: "Extract: main argument, methodology, key findings"
  Apply to: 5 sources
  Result: 5 new notes with consistent structure

When to use:
  - Same extraction from many sources
  - Building structured knowledge base
  - Creating consistent summaries

---

Using Transformations for Batch Insights

Built-in Transformations

Open Notebook comes with presets:

Summary

Extracts: Main points, key arguments, conclusions
Output: 200-300 word summary of source
Best for: Quick reference summaries

Key Concepts

Extracts: Main ideas, concepts, terminology
Output: List of concepts with explanations
Best for: Learning and terminology

Methodology

Extracts: Research approach, methods, data
Output: How the research was conducted
Best for: Academic sources, methodology review

Takeaways

Extracts: Actionable insights, recommendations
Output: What you should do with this information
Best for: Practical/business sources

How to Apply Transformation

1. Go to "Transformations"
2. Select a template
3. Click "Apply"
4. Select which sources (one or many)
5. Wait for processing (usually 30 seconds - 2 minutes)
6. New notes appear in your notebook
7. Edit if needed

Create Custom Transformation

1. Click "Create Custom Transformation"
2. Write your extraction template:

   Example:
   "For this academic paper, extract:
    - Central research question
    - Hypothesis tested
    - Methodology used
    - Key findings (numbered)
    - Limitations acknowledged
    - Recommendations for future work"

3. Click "Save Template"
4. Apply to one or many sources
5. System generates notes with consistent structure

---

Organizing Notes

Naming Conventions

Option 1: Date-based

2026-01-03 - Key points from X source
2026-01-04 - Comparison between A and B
Benefit: Easy to see what you did when

Option 2: Topic-based

AI Safety - Alignment approaches
AI Safety - Interpretability research
Benefit: Groups by subject matter

Option 3: Type-based

SUMMARY: Paper on X
QUESTION: What about Y?
INSIGHT: Connection between Z and W
Benefit: Easy to filter by type

Option 4: Source-based

From: Paper A - Main insights
From: Video B - Interesting implications
Benefit: Easy to trace back to sources

Best practice: Combine approaches

[Date] [Source] - [Topic] - [Type]
2026-01-03 - Paper A - AI Safety - Takeaways

Using Tags

Tags are labels for categorization. Add them when creating notes:

Example tags:
  - "primary-research" (direct source analysis)
  - "background" (supporting material)
  - "methodology" (about research methods)
  - "insights" (your original thinking)
  - "questions" (open questions raised)
  - "follow-up" (needs more work)
  - "published" (ready to share/use)

Benefits of tags:

• Filter notes by tag
• Find all notes of a type
• Organize workflow (e.g., find all "follow-up" notes)

Note Linking & References

You can reference sources within notes:

# Analysis of Paper A

As shown in Paper A (see "main argument" section),
the authors argue that...

## Related Sources
- Paper B discusses similar approach
- Video C shows practical application
- My note on "Comparative analysis" has more

---

Editing and Refining Notes

Improving AI-Generated Notes

AI Note:
  "The paper discusses machine learning"

What you might change:
  "The paper proposes a supervised learning approach
   to classification problems, using neural networks
   with attention mechanisms (see pp. 15-18)."

How to edit:
  1. Click note
  2. Click "Edit"
  3. Refine the content
  4. Click "Save"

Adding Citations

When saving from Chat/Ask:
  - Citations auto-added
  - Shows which sources informed answer
  - You can verify by clicking

When manual notes:
  - Add manually: "From Paper A, page 15: ..."
  - Or reference: "As discussed in [source]"

---

Searching Your Notes

Notes are fully searchable:

Text Search

Find exact phrase: "attention mechanism"
Results: All notes containing that phrase
Use when: Looking for specific terms or quotes

Vector/Semantic Search

Find concept: "How do models understand?"
Results: Notes about interpretability, mechanistic understanding, etc.
Use when: Exploring conceptually (words not exact)

Combined Search

Text search notes → Find keyword matches
Vector search notes → Find conceptual matches
Both work across sources + notes together

---

Exporting and Sharing Notes

Options

Copy to clipboard

Click "Share" → "Copy" → Paste anywhere
Good for: Sharing one note via email/chat

Export as Markdown

Click "Share" → "Export as MD" → Saves as .md file
Good for: Sharing with others, version control

Create note collection

Select multiple notes → "Export collection"
→ Creates organized markdown document
Good for: Sharing a topic overview

Publish to web

Click "Publish" → Get shareable link
Good for: Publishing publicly (if desired)

---

Organizing Your Notebook's Notes

By Research Phase

Phase 1: Discovery

• Initial summaries
• Questions raised
• Interesting findings

Phase 2: Deep Dive

• Detailed analysis
• Comparative insights
• Methodology reviews

Phase 3: Synthesis

• Connections across sources
• Original thinking
• Conclusions

By Content Type

Summaries

• High-level overviews
• Generated by transformations
• Quick reference

Questions

• Open questions
• Things to research more
• Gaps to fill

Insights

• Your original analysis
• Connections made
• Conclusions reached

Tasks

• Follow-up research
• Sources to add
• People to contact

---

Using Notes in Other Features

In Chat

You can reference notes:
"Based on my note 'Key findings from A',
how does this compare to B?"

Notes become part of context.
Treated like sources but smaller/more focused.

In Transformations

Notes can be transformed:
1. Select notes as input
2. Apply transformation
3. Get new derived notes

Example: Transform 5 analysis notes → Create synthesis

In Podcasts

Notes are used to create podcast content:
1. Generate podcast for notebook
2. System includes notes in content selection
3. Notes become part of episode outline

---

Best Practices

For Manual Notes

1. Write clearly — Future you will appreciate it
2. Add context — Why this matters, not just what it says
3. Link to sources — You can verify later
4. Date them — Track your thinking over time
5. Tag immediately — Don't defer organization

For AI-Generated Notes

1. Review before saving — Verify quality
2. Edit for clarity — AI might miss nuance
3. Add your thoughts — Make it your own
4. Include citations — Understand sources
5. Organize right away — While context is fresh

For Organization

1. Consistent naming — Your future self will thank you
2. Tag everything — Makes filtering later much easier
3. Link related notes — Create knowledge network
4. Review periodically — Refactor as understanding evolves
5. Archive old notes — Keep working space clean

---

Common Mistakes

Mistake	Problem	Solution
Save every Chat response	Notebook becomes cluttered with low-quality notes	Only save good responses that answer your questions
Don't add tags	Can't find notes later	Tag immediately when creating
Poor note titles	Can't remember what's in them	Use descriptive titles, include key concept
Never link notes together	Miss connections between ideas	Add references to related notes
Forget the source	Can't verify claims later	Always link back to source
Never edit AI notes	Keep generic AI responses	Refine for clarity and context
Create one giant note	Too long to be useful	Split into focused notes by subtopic

---

Summary: Note Lifecycle

1. CREATE
   ├─ Manual: Write from scratch
   ├─ From Chat: Save good response
   ├─ From Ask: Save synthesis
   └─ From Transform: Batch process

2. EDIT & REFINE
   ├─ Improve clarity
   ├─ Add context
   ├─ Fix AI mistakes
   └─ Add citations

3. ORGANIZE
   ├─ Name clearly
   ├─ Add tags
   ├─ Link related
   └─ Categorize

4. USE
   ├─ Reference in Chat
   ├─ Transform for synthesis
   ├─ Export for sharing
   └─ Build on with new questions

5. MAINTAIN
   ├─ Periodically review
   ├─ Update as understanding grows
   ├─ Archive when done
   └─ Learn from organized knowledge

Your notes become your actual knowledge base. The more you invest in organizing them, the more valuable they become.