Skip to content

docs: lead with Taskade's story (demote n8n, add ToC) - #41

Closed
johnxie wants to merge 1 commit into
fix/tool-count-57from
docs/readme-positioning
Closed

docs: lead with Taskade's story (demote n8n, add ToC)#41
johnxie wants to merge 1 commit into
fix/tool-count-57from
docs/readme-positioning

Conversation

@johnxie

@johnxie johnxie commented Jun 5, 2026

Copy link
Copy Markdown
Member

What & why

The README promoted a converging competitor (n8n) and cast Taskade as a spoke of n8n's hub ("Connect Taskade to 400+ apps via n8n"), while also linking a dead N8N_WORKFLOW_GUIDE.md. This reframes the README around Taskade as the orchestrator.

Changes

  • Tagline: drop n8n, feature VS Code instead.
  • Delete the ### n8n Automation Integration section + its dead guide link (also fixes the broken link — by deletion).
  • De-brand ### 4. HTTP / SSE Mode (for n8n…)(remote & custom clients).
  • Add a Table of Contents (444-line file) for navigation + GitHub-anchor SEO.

Zero-regression

  • Markdown only. n8n compatibility is preservedexamples/n8n-taskade-mcp-workflow.json stays, and HTTP mode still serves any HTTP MCP client. This is editorial positioning, not a capability change.
  • Verified: 0 n8n references remain in README; 0 N8N_WORKFLOW_GUIDE links; all 11 ToC anchors resolve to real ## headers.
  • glama.json intentionally NOT changed — its schema (glama.ai/mcp/schemas/server.json) permits only maintainers; adding description/tags would be schema-invalid.

Stacked on

- Drop n8n from the headline tagline (n8n is a converging competitor in
  automations/Genesis); feature VS Code instead.
- Remove the dedicated 'n8n Automation Integration' section and its dead
  ./N8N_WORKFLOW_GUIDE.md link (the 'connect Taskade to 400+ apps via n8n'
  framing positioned Taskade as a spoke of a competitor's hub).
- De-brand the HTTP/SSE section header from 'for n8n' to 'remote & custom clients'.
- Add a Table of Contents (444-line README) for navigation + anchor SEO.

n8n compatibility is unchanged (examples/n8n-taskade-mcp-workflow.json kept; HTTP
mode still works for any HTTP MCP client) — this is editorial positioning only.
Note: glama.json was NOT enriched — its schema only permits 'maintainers'.
@johnxie
johnxie requested a review from Copilot June 5, 2026 11:08
@changeset-bot

changeset-bot Bot commented Jun 5, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 7f2d343

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the repository README to reposition Taskade as the primary orchestrator (removing competitor-centric framing), improve navigation with a Table of Contents, and eliminate a previously broken n8n guide link—without changing any runtime behavior or compatibility.

Changes:

  • Updated the top tagline to remove n8n and include VS Code as an example client.
  • Added a README Table of Contents for easier navigation across major sections.
  • De-branded the HTTP/SSE mode heading and removed the n8n-specific integration section (including the dead N8N_WORKFLOW_GUIDE.md link).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@johnxie

johnxie commented Jun 5, 2026

Copy link
Copy Markdown
Member Author

✅ Validation & QA — ready to merge

Copilot reviewed with no inline comments. Re-validated:

Check Result
n8n removed from headline tagline
dead N8N_WORKFLOW_GUIDE.md link removed (0 refs) ✓
ToC anchors → real ## sections 11/11 resolve ✓
n8n compatibility (examples/HTTP) preserved (editorial only) ✓

Markdown only. Confidence: high · zero regression. Merging.

@johnxie
johnxie deleted the branch fix/tool-count-57 June 5, 2026 11:56
@johnxie johnxie closed this Jun 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants