Skip to content

feat: Workbenches Docs#602

Open
JohnBlackwell wants to merge 8 commits into
mainfrom
john/prod-4817-begin-working-on-workbench-documentation
Open

feat: Workbenches Docs#602
JohnBlackwell wants to merge 8 commits into
mainfrom
john/prod-4817-begin-working-on-workbench-documentation

Conversation

@JohnBlackwell
Copy link
Copy Markdown
Contributor

Plural Flow: docs
Plural Preview: docs

@JohnBlackwell JohnBlackwell requested a review from a team as a code owner May 18, 2026 01:23
Copy link
Copy Markdown
Contributor

@plural-copilot plural-copilot Bot left a comment

Choose a reason for hiding this comment

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

✅ Deploy preview for docs-pr-602 is ready!

Name Details
⚡ Service docs-pr-602 (5 / 5 ready)
☁️ Cluster plural (eks)
:octocat: Commit sha 466c50c
Plural URL https://console.mgmt.plural.sh/cd/clusters/446acdef-8524-425a-a49f-5336a...
🔍 Logs URL https://console.mgmt.plural.sh/cd/clusters/446acdef-8524-425a-a49f-5336a...
🌊 Flow URL https://console.mgmt.plural.sh/flows/08a17af1-8578-449e-9ae1-28ccd97eafc...
Preview Link Preview

You can learn more about preview environments and Plural Flows here

@linear
Copy link
Copy Markdown

linear Bot commented May 18, 2026

PROD-4817

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 18, 2026

Greptile Summary

This PR adds a new Workbenches documentation section covering six pages: overview (index.md), workbench setup wizard (configuration.md), coding agent (coding-agent.md), tools reference (tools.md), running jobs (running-jobs.md), automation triggers (automation.md), and common use cases (use-cases.md). Supporting screenshot assets and routing entries in docs-structure.ts and generated/routes.json are also included.

  • Nine screenshot assets are added under public/assets/workbenches/ and referenced correctly in the markdown pages.
  • All six new routes are registered in routes.json with matching relPath values, and the docs-structure.ts section lists all pages in the correct order.

Confidence Score: 4/5

Safe to merge after addressing the outstanding broken-link threads; the content itself is well-structured and the routing additions are correct.

There are open threads from the previous review round flagging broken cross-links (notably the ../flows/index.md trailing-/index pattern in index.md and running-jobs.md) that are still present in the current revision and have not yet been resolved.

pages/plural-features/workbenches/index.md and pages/plural-features/workbenches/running-jobs.md — the ../flows/index.md relative links flagged in the previous review round remain unaddressed.

Important Files Changed

Filename Overview
pages/plural-features/workbenches/automation.md New automation reference page; overview intro mis-states "two mechanisms" while the page documents three (cron, webhooks, and flow-triggered jobs)
pages/plural-features/workbenches/index.md New workbenches overview page; previously-flagged evaluations and ./evaluations broken links appear to have been removed in this revision
pages/plural-features/workbenches/running-jobs.md New running-jobs reference page; content and anchor targets are accurate
pages/plural-features/workbenches/configuration.md New 5-step wizard setup guide; links to AgentRuntime and multi-tenancy pages are valid
pages/plural-features/workbenches/tools.md New tools reference page; all anchor targets, tool categories, and credential fields are consistent
pages/plural-features/workbenches/coding-agent.md New coding agent guide; AgentRuntime link resolves correctly to /plural-features/plural-ai/ai-agent/configure-agent
pages/plural-features/workbenches/use-cases.md New use-case walkthroughs; all cross-links to tools anchors and coding-agent resolve correctly
src/routing/docs-structure.ts Adds workbenches section with six child pages; all paths match the new markdown files and routes.json entries
generated/routes.json Adds seven new workbench routes; all relPaths match the added markdown files with no missing or mismatched entries

Reviews (6): Last reviewed commit: "fix broken links" | Re-trigger Greptile

Comment thread pages/plural-features/workbenches/index.md Outdated
Comment thread pages/plural-features/workbenches/running-jobs.md Outdated
@JohnBlackwell
Copy link
Copy Markdown
Contributor Author

@greptile

@JohnBlackwell
Copy link
Copy Markdown
Contributor Author

@greptile

Comment thread pages/plural-features/workbenches/automation.md
@JohnBlackwell
Copy link
Copy Markdown
Contributor Author

@greptile

Comment thread pages/plural-features/workbenches/automation.md Outdated
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 18, 2026

Want your agent to iterate on Greptile's feedback? Try greploops.

@JohnBlackwell
Copy link
Copy Markdown
Contributor Author

@greptile

Comment thread pages/plural-features/workbenches/automation.md Outdated
JohnBlackwell and others added 2 commits May 17, 2026 21:50
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
@JohnBlackwell
Copy link
Copy Markdown
Contributor Author

@greptile

Copy link
Copy Markdown
Member

@michaeljguarino michaeljguarino left a comment

Choose a reason for hiding this comment

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

a number of comments, a lot probably to remove some llm hallucination artifacts

Comment thread pages/plural-features/workbenches/coding-agent.md Outdated
Comment thread pages/plural-features/workbenches/coding-agent.md
Comment thread pages/plural-features/workbenches/configuration.md Outdated
Comment thread pages/plural-features/workbenches/configuration.md Outdated
Comment thread pages/plural-features/workbenches/configuration.md Outdated
Comment thread pages/plural-features/workbenches/running-jobs.md Outdated
Comment thread pages/plural-features/workbenches/running-jobs.md
Comment thread pages/plural-features/workbenches/tools.md
Comment thread pages/plural-features/workbenches/use-cases.md Outdated
@JohnBlackwell
Copy link
Copy Markdown
Contributor Author

Thanks, yeah used LLM for first draft, will update.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants