docs: split Pull Requests into its own page, refresh Tasks doc and screenshots

apps/docs/content/docs/meta.json

@@ -26,6 +26,7 @@
 		"agent-integration",
 		"agent-status",
 		"tasks",
+		"pull-requests",
 		"remote-workspaces",
 		"automations",
 		"usage",

apps/docs/content/docs/pull-requests.mdx

@@ -0,0 +1,66 @@
+---
+title: Pull Requests
+description: Review, check, and merge PRs from your projects without leaving the app
+---
+
+The **Pull requests** view brings the PRs from your projects' GitHub repositories into Superset, so the loop of reviewing, fixing, and merging agent work never leaves the app. It's a destination in the dashboard sidebar with a resizable split view: the PR list on the left, and a full detail view — rendered description, CI checks, and the complete diff — on the right.
+
+![The Pull requests split view: filterable list on the left, detail with rendered markdown on the right](/images/pull-requests-view.png)
+
+## Browse and Filter
+
+The list shows every PR from the repositories behind your projects. Each row carries the repo, PR number, title, author, a compact CI check summary (passed/total), age, and the +added/−deleted line counts.
+
+- **State tabs**: **All**, **Open**, or **Merged**
+- **Repository**: multi-select across your projects' repos
+- **Author**: filter to a specific GitHub author
+- **Reviews**: review-status filter — *No reviews*, *Review required*, *Approved review*, *Changes requested*, *Reviewed by you*, *Not reviewed by you*, *Awaiting review from you*, or *Awaiting review from you or your team*
+- **Search**: find PRs by title or number
+
+Filters persist, so the view comes back the way you left it. Active filters show a count badge next to the search box.
+
+## The Detail View
+
+Selecting a PR opens it in the right pane, with **Summary** and **Code** tabs. Toggles at either end of the header collapse the list or the detail pane when you want more room; on narrow windows the panes stack automatically.
+
+### Summary
+
+The PR description renders as full markdown — headings, lists, code spans, and links. Alongside it:
+
+- **Checks**: every CI check with its status and a link to the run on GitHub. The header summarizes the state at a glance ("All 12 passed"). Cancelled checks count as failures, not successes.
+- Review status and reviewers for the PR
+- The comment thread, with a composer for replying
+
+![PR checks alongside the summary, with Start Workspace and Merge actions in the header](/images/pr-checks.png)
+
+### Code
+
+The **Code** tab is a complete diff viewer: a file tree with per-file added/deleted counts and modified/renamed markers, syntax-highlighted diffs, collapsed unmodified regions, and unified or side-by-side layouts. A **Files** dropdown jumps to any file in the changeset.
+
+![The Code tab: file tree plus syntax-highlighted diffs](/images/pr-code-view.png)
+
+### Comment Straight to an Agent
+
+Select lines in the Code tab and write a comment — then send it to an agent instead of (or as well as) leaving it on GitHub. The comment goes out with the file, line range, and side baked in:
+
+- If a workspace is already linked to the PR, send it to one of its **running agent terminals**, or start a **new agent session** there
+- If no workspace exists yet, Superset **creates a PR-checkout workspace** and launches the agent with your comment as its first prompt
+
+That turns "this function should handle the empty case" from a review comment into a running fix.
+
+## Actions
+
+From the detail header:
+
+- **Start Workspace** - check out the PR into a new workspace to run, test, or continue it. See [Workspaces](/workspaces)
+- **Merge** - choose **Squash and merge** (combine all commits), **Merge commit** (preserve commit history), or **Rebase and merge** (reapply all commits)
+- **Close** / reopen the PR
+- Open the PR on GitHub
+
+<Callout type="info">
+Merging, closing, and commenting act on the real PR through your GitHub connection - same permissions, same effects as doing it on github.com.
+</Callout>
+
+## Where PRs Come From
+
+PRs sync from the GitHub repositories of your connected projects; connect GitHub under project settings and the list stays fresh automatically. PR-based workspaces also surface review status and checks on their sidebar entries — see [PR Status](/workspaces#pr-status) — and the [PR feedback recipe](/recipes/pr-feedback) shows the full loop of turning review comments into agent runs.

apps/docs/content/docs/tasks.mdx

@@ -1,33 +1,40 @@
 ---
-title: Tasks & Pull Requests
-description: Track work items and pull requests without leaving the app
+title: Tasks
+description: Track work items and delegate them to agents without leaving the app
 ---
 
-The **Tasks** and **Pull requests** views bring your issue tracker and open pull requests into Superset, so delegating a task to an agent doesn't start with a copy-paste from Linear. Each is its own destination in the dashboard sidebar, with independent filters that are restored when you come back.
+The **Tasks** view brings your issue tracker into Superset, so delegating a task to an agent doesn't start with a copy-paste from Linear or GitHub. It's a destination in the dashboard sidebar with independent filters that are restored when you come back. Pull requests have their own view — see [Pull Requests](/pull-requests).
 
-![Creating a task from the desktop](/images/create-task.png)
+![The Tasks view on the GitHub issues source, with per-row Add to workspace actions](/images/task-list.png)
 
 ## Where Tasks Come From
 
-Tasks sync from your connected tracker (see [Linear Integration](/use-with-linear)) alongside Superset-native tasks, and GitHub Issues are available as a source inside the Tasks view. The Linear source lists issues from the whole connected workspace; filter by status, priority, or assignee to narrow it to yours.
+A source toggle at the top of the view switches between:
+
+- **Linear** - issues synced from your connected workspace (see [Linear Integration](/use-with-linear)), listed alongside Superset-native tasks you create in the app
+- **GitHub issues** - open issues from your projects' repositories, with a repository filter and per-row **Add to workspace** buttons
+
+The Linear source lists issues from the whole connected workspace; filter by project, status, or assignee to narrow it to yours.
 
 ## What You Can Do
 
-- **Table view** with sorting and filters for status, priority, assignee, and task state (Active, Backlog, Todo, In progress, Done, Canceled)
-- **Repository filter**: multi-select; empty means all repositories
+- **List and board views**: a sortable table or a kanban board grouped by status
+- **Filters** for project, task state, and assignee; empty filters mean everything
 - **Semantic search**: find tasks by meaning, not just keywords
-- **Create tasks** from the desktop with the task create modal
-- **Task detail actions**: quick actions on individual tasks without switching to Linear
+- **Multi-select**: check several tasks and act on them together
+- **Create tasks** from the desktop with the **New task** modal — title, description, status, priority, and assignee
 
-## From Task to Workspace
+![Creating a task from the desktop](/images/create-task.png)
 
-The point of having tasks in Superset is delegation. Launch an agent from a task and the task's content becomes the agent's prompt:
+Opening a task shows its full detail: an editable title, description, activity, and a properties sidebar for status, priority, and assignee — plus quick actions without switching to Linear.
 
-- The **Task Prompt Template** (per agent, under **Settings → Agents**) controls how the task is turned into a prompt
-- The **Auto-run command** toggle controls whether the agent starts immediately or stages the command for review
+## From Task to Workspace
 
-## Pull Requests
+The point of having tasks in Superset is delegation. Launch an agent from a task and the task's content becomes the agent's prompt:
 
-![The Pull requests view with filters and check summaries](/images/pull-requests-view.png)
+- **Run in workspace** on a task (or a multi-selection of tasks) picks a project and an agent, then creates a workspace per task with the agent already working
+- The **Auto-run command** toggle controls whether each agent starts immediately or stages the command for review
+- The **Task Prompt Template** (per agent, under **Settings → Agents**) controls how a task is turned into the agent's prompt
+- On the GitHub issues source, **Add to workspace** does the same for a single issue
 
-The **Pull requests** view lists PRs from your projects' repositories, with repository (multi-select), state, author, review-status, and search filters. Review status covers requests for you and your teams. Rows show a compact CI check summary; the detail view has a full **Checks** section. PR-based workspaces also show review status and checks in the sidebar. See [Workspaces](/workspaces#pr-status) and the [Diff Viewer](/diff-viewer) for the review loop.
+When the agents finish, their branches come back as PRs — review and merge them from [Pull Requests](/pull-requests).