Skip to content

Commit 97a4749

Browse files
committed
docs: clarify GitHub Issues workflow for Linear migration
- Clarify that tool creates GitHub Issues (not direct Linear/Jira import) - Explain Linear migration workflow: CSV → GitHub Issues → Linear's GitHub import - Update decision chart to reflect 'migrating to Linear via GitHub' - Add helpful tip about using Linear's native GitHub import feature - Remove misleading 'direct Linear/Jira migration' language
1 parent 6df5691 commit 97a4749

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

README.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
**Zero-config CLI to bulk upload CSV data to GitHub Issues**
44

5-
Perfect for Linear/Jira migrations - works with any CSV format, no setup required.
5+
Perfect for platform migrations - create GitHub Issues from your CSV exports, then use Linear's native GitHub import to sync.
66

77
## 🚀 Quick Start
88

@@ -15,16 +15,16 @@ npx upload-git-issues issues.csv --dry-run --verbose
1515
```
1616

1717
**What happens:**
18-
1. Interactive prompts guide you through authentication and repo selection
19-
2. Intelligent CSV parsing (works with Linear, Jira, any format)
18+
1. Interactive prompts guide you through GitHub authentication and repo selection
19+
2. Intelligent CSV parsing (works with Linear exports, Jira exports, any CSV format)
2020
3. Beautiful progress indicators show real-time status
21-
4. Direct links to all created issues
21+
4. Issues created in GitHub - ready for Linear's native GitHub import
2222

2323
## 📋 When to Use This Tool
2424

2525
| **Your Situation** | **Use This Tool?** | **Why** |
2626
| ------------------------------------------ | ---------------------------- | --------------------------------------------- |
27-
| **🔄 Migrating from Linear/Jira/Asana** |**Perfect Choice** | Works with exports out-of-the-box, zero setup |
27+
| **🔄 Migrating to Linear via GitHub** |**Perfect Choice** | Create GitHub Issues, then use Linear's GitHub import |
2828
| **📊 Have CSV data to upload** |**Perfect Choice** | Intelligent parsing handles any CSV format |
2929
| **⚡ Need it done quickly** |**Perfect Choice** | One command, 2 minutes to complete |
3030
| **🏢 Enterprise/Security requirements** |**Perfect Choice** | Built-in security audits and compliance |
@@ -61,6 +61,8 @@ Title,Description,Labels,Assignee,Priority
6161

6262
The tool intelligently maps column names (Title/title/TITLE all work) and converts Priority/Status to labels.
6363

64+
> **💡 Linear Migration Tip:** After creating GitHub Issues, use Linear's native GitHub import feature to sync them into your Linear workspace.
65+
6466
## 🔑 GitHub Authentication
6567

6668
Create a [Personal Access Token](https://github.com/settings/tokens) with `repo` scope. The tool will prompt you for it.

0 commit comments

Comments
 (0)