Skip to content

docs: Simplify the front door pages and align navigation labels - #116

Merged
johnxie merged 1 commit into
mainfrom
polish/site-nov-12
Nov 12, 2026
Merged

johnxie merged 1 commit into
mainfrom
polish/site-nov-12

Conversation

@johnxie

@johnxie johnxie commented Nov 12, 2026

Copy link
Copy Markdown
Member

Polish of the docs.taskade.com front door. The navigation groups, their order and the page structure stay as they are.

What changed

Theme Pages What a reader sees now
Simpler first screen README.md One plain intro, then the three start cards. The repeated "Welcome to Taskade" block is gone. Quick start labels match the navigation.
Plain words, one next step run-your-business/README.md, help-center/README.md, changelog-2026/README.md, changelog/README.md Short sentences. No repeated hints, no unverifiable claims, no exclamation marks. The Help Center has one goal table and one topic list.
Agent quick start getting-started/ai-agents.md Description under 160 characters. The connection check is one instruction per sentence.
Navigation labels SUMMARY.md Labels only: title case on two MCP entries, "Taskade API Overview" and "Create Project in Workspace" match their pages, "Integrations by App" no longer looks like the two other integration entries. No entry moved, no file renamed, no URL changed.

Checks

  • node .github/scripts/check-facts.mjs: 0 problems.
  • node .github/scripts/check-twins.mjs --offline: twin footers ok.
  • A link and anchor script over every .md file: no broken relative link or anchor in the repo.
  • git diff --stat origin/main: 7 files, no file renamed, no SUMMARY.md entry moved between groups, no file from the parallel drift update touched.

- Home: one plain intro and the three start cards on the first screen. Remove the repeated welcome block. Quick start labels match the navigation.
- Run Your Business, Help Center and Changelog (2026): plain words, one clear next step, no repeated hints or unverifiable claims.
- Connect an AI Agent: description under 160 characters, one instruction per sentence in the connection check.
- SUMMARY.md: label fixes only (title case, labels that match the page, no near-duplicate integration labels). No URL changes.
Copilot AI lite review requested due to automatic review settings November 12, 2026 20:31

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

Approval is blocked by two active documentation issues: a prohibited capability count remains published, and the MCP description conflates distinct product capabilities.

2 open issues
What changed in this PR

This docs-only pull request simplifies Taskade’s front-door pages, streamlines introductory guidance, and aligns navigation labels with page titles without changing the site structure or URLs.

Changes:

  • Simplifies the homepage, Help Center, business guide, and changelog introductions.
  • Clarifies AI-agent connection instructions.
  • Updates navigation labels for consistency with corresponding page titles.
File Description
updates-and-timeline/​changelog-2026/​README.md Simplifies the 2026 changelog introduction and release-note guidance.
SUMMARY.md Updates navigation labels without changing entry order, structure, or URLs.
README.md Simplifies the homepage introduction, cards, platform overview, and quick-start links.
help-center/​README.md Reorganizes help content into a concise goal table and topic-based guide list.
getting-started/​ai-agents.md Shortens the page description and clarifies the connection verification steps.
genesis-living-system-builder/​run-your-business/​README.md Streamlines the business-app journey and post-launch guidance.
changelog/​README.md Simplifies the historical changelog introduction and heading.

Review effort: Lite

Comment thread README.md
1. [**Automation Getting Started**](genesis-living-system-builder/automation/) - Build your first workflow
2. [**Integration Guide**](genesis-living-system-builder/automation/integrations.md) - 100+ supported services
1. [**Automations Overview**](genesis-living-system-builder/automation/) - build your first workflow
2. [**Integration Options**](genesis-living-system-builder/automation/integrations.md) - 100+ integrations
* **Extend your live system:** read & write your data with [Workspace MCP](../../apis-living-system-development/workspace-mcp.md), orchestrate agents and edit your app's code with the [Hosted Taskade MCP](../../apis-living-system-development/genesis-app-mcp.md), or connect external tools with [MCP Connectors](../genesis/mcp-connectors.md).
* [What your app costs](../../account-management/credits-and-billing.md): plans and AI credits.
* [Run your live app by talking to Claude](../../apis-living-system-development/run-your-app-with-ai.md): read and change the data of your app in plain English.
* [Workspace MCP](../../apis-living-system-development/workspace-mcp.md) and [Hosted Taskade MCP](../../apis-living-system-development/genesis-app-mcp.md): let an AI client read and write your data and edit the code of your app.
@johnxie
johnxie merged commit 3e88164 into main Nov 12, 2026
8 checks passed
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