Uploading Documents - Best Practices¶

Learn how to prepare and upload documents for optimal timeline extraction.

Supported File Formats¶

Document Type Guidelines¶

Resumes (Best Results)¶

Why resumes work well:

• Clear chronological structure
• Explicit dates and durations
• Standardized sections

Optimization tips:

✅ DO:
- Use standard section headers (Experience, Education)
- Include month/year dates (Jan 2020 - Mar 2023)
- Separate entries with clear spacing
- Include locations (City, State/Country)

❌ DON'T:
- Use vague dates ("recently", "a while ago")
- Merge multiple jobs in one paragraph
- Skip locations
- Use images instead of text

Example format:

PROFESSIONAL EXPERIENCE

Senior Software Engineer
TechCorp Inc., San Francisco, CA
June 2020 - Present
• Led development team of 5 engineers
• Built ML pipeline processing 1M+ events/day

Cover Letters (Good Results)¶

Why they work:

• Narrative with timeline
• Specific achievements
• Clear transitions

Tips: - Mention specific dates when discussing experiences - Use paragraphs with clear timeframes - Reference positions and companies explicitly

Personal Statements (Good Results)¶

Academic/professional narratives:

• Research timelines
• Publication dates
• Conference presentations

Tips: - Include dates for all milestones - Mention specific projects/publications - Reference institutions and locations

Pre-Upload Checklist¶

Before uploading, verify:

• Dates are explicit - Month/Year minimum
• Text is selectable - Not a scanned image
• Structure is clear - Headings and sections
• File size < 10MB - For optimal processing
• Format is supported - PDF, TXT, DOCX, MD

Upload Process¶

Step 1: Access Upload Tab¶

Navigate to 📤 Upload & Process tab

Step 2: Choose Upload Method¶

Step 3: Configure Settings (Optional)¶

Step 4: Process¶

1. Click 🚀 Process Documents
2. Monitor progress bar
3. Check success message

Optimizing Document Content¶

Date Formatting¶

Best formats:

✅ Excellent:
- January 2020 - March 2023
- 01/2020 - 03/2023
- 2020-01 to 2023-03
- Jan 2020 - Present

⚠️ Acceptable:
- 2020 - 2023 (year only)
- Q1 2020 - Q4 2023
- Spring 2020 - Summer 2023

❌ Poor:
- "recently"
- "a few years ago"
- "during college"
- "around 2020"

Event Descriptions¶

Effective descriptions:

✅ Good:
"Led team of 5 developers building cloud-native microservices
architecture serving 1M+ daily users across AWS infrastructure"

❌ Poor:
"Worked on some projects with the team"

Key elements:

• Action verbs (Led, Built, Managed)
• Quantifiable metrics (5 developers, 1M users)
• Technologies/tools (AWS, microservices)
• Impact/results (serving 1M+ users)

Location Information¶

Include when relevant:

✅ Complete:
Google, Mountain View, CA
Stanford University, Stanford, CA, USA
Remote (based in Seattle, WA)

⚠️ Partial:
Google (city missing)
Mountain View (company missing)

❌ Vague:
"Bay Area"
"US West Coast"

Handling Different Document Types¶

Multi-Page Resumes¶

Processing tips:

• Ensure all pages are included
• Keep consistent formatting across pages
• Use page breaks appropriately
• Verify file size < 10MB

Scanned Documents¶

If you must use scanned PDFs:

1. Use OCR first:

   # Example with ocrmypdf
   ocrmypdf input.pdf output.pdf
   

2. Verify text extraction:

3. Open PDF in viewer
4. Try selecting text

5. Ensure it's readable

6. Clean up OCR artifacts:

7. Fix garbled characters
8. Correct date formatting
9. Review spacing issues

Multiple Language Documents¶

Current support:

• ✅ English (full support)
• ⚠️ Spanish, French, German (partial)
• ❌ Non-Latin scripts (limited)

Tips for multilingual:

• Keep dates in ISO format (YYYY-MM-DD)
• Use English month names when possible
• Translate key sections if accuracy critical

Batch Processing¶

Uploading Multiple Documents¶

When to batch process:

• Multiple resumes from different periods
• Related documents (resume + cover letters)
• Complete career documentation set

Best practices:

1. Start with most important document
2. Process in chronological order (oldest to newest)
3. Review after each document before uploading next
4. Use clear filenames (resume_2020.pdf, resume_2023.pdf)

Managing Duplicates¶

ChronoScope automatically detects similar events:

⚠️ Potential duplicate detected:
   Event 1: "Senior Developer at TechCorp" (2020-2023)
   Event 2: "Senior Software Engineer, TechCorp" (2020-2023)
   Similarity: 87%

   [ Keep Both ]  [ Merge ]  [ Delete Event 2 ]

Troubleshooting Upload Issues¶

File Won't Upload¶

No Events Extracted¶

Poor Extraction Quality¶

File Organization Tips¶

Recommended Structure¶

my-timeline-docs/
├── resumes/
│   ├── 2020_chronological_resume.pdf
│   ├── 2023_current_resume.pdf
│   └── academic_cv_2022.pdf
├── cover-letters/
│   ├── techcorp_application_2020.pdf
│   └── startup_cover_letter_2023.pdf
└── other/
    ├── linkedin_profile_export.txt
    └── personal_statement_grad_school.pdf

Naming Conventions¶

Good filenames:

✅ resume_2023_current.pdf
✅ cover_letter_google_application.pdf
✅ cv_academic_2022.pdf

Poor filenames:

❌ document.pdf
❌ untitled.docx
❌ IMG_2023.pdf

Next Steps¶

After uploading:

• 📈 View Your Timeline
• 🔍 Filter Events
• ✅ Validate Quality
• 📊 Visualize Data

Quick Reference¶