Skip to content

Workflows updates#6023

Merged
ethanpalm merged 20 commits into
mainfrom
workflows-v2
May 29, 2026
Merged

Workflows updates#6023
ethanpalm merged 20 commits into
mainfrom
workflows-v2

Conversation

@ethanpalm
Copy link
Copy Markdown
Collaborator

@ethanpalm ethanpalm commented May 28, 2026

Documentation changes

This PR updates the workflow docs based on recent changes to the feature.

  • Adds new workflows guide to replace the automate agent via API guide
  • Combines enable and manage workflows pages into a single manage workflows page
  • Updates screenshots
  • Adds reference of all predefined workflows
  • Clarifies credit usage, plus tips for controlling credit use

Closes https://linear.app/mintlify/issue/DOC-382/workflow-docs-updates


For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

  • Code examples work as written
  • Commands and configurations are correct
  • Links resolve to the right destinations
  • Prerequisites and requirements are accurate

✅ Clarity and completeness

  • Instructions are clear and easy to follow
  • Steps are in logical order
  • Nothing important is missing
  • Examples help illustrate the concepts

✅ User experience

  • A new user could follow these docs successfully
  • Common gotchas or edge cases are addressed
  • Error messages or troubleshooting guidance is helpful

Note

Low Risk
Documentation-only changes (navigation, redirects, and copy); no application code or security-sensitive behavior.

Overview
This PR restructures the Workflows documentation to match the updated product: new information architecture, consolidated setup docs, and clearer guidance on triggers, credits, and predefined workflows.

The navigation now orders pages as overview → predefined reference → manage → create, drops the separate Enable page (content moves into Manage workflows), and adds /workflows/reference for all built-in workflows. /workflows/enable redirects to /workflows/manage.

Manage workflows becomes the single place to enable workflows, configure triggers (content update, code change, custom schedule), update mode, context repos, and instructions—aligned with settings opening in a side panel (not a modal). workflows/enable.mdx is removed.

Workflows overview documents three trigger types, links runs to credit usage, and adds next-step cards. A new Use workflows guide covers when to automate, writing instructions, context repos, credit control, and reviewing runs; it’s linked from Guides and Create a custom workflow.

Changelog and cross-links rename the assistant workflow to Draft improvements from assistant conversations and point at the new reference anchor.

Reviewed by Cursor Bugbot for commit 72fca6f. Bugbot is set up for automated code reviews on this repo. Configure here.

@ethanpalm ethanpalm marked this pull request as ready for review May 28, 2026 20:04
Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

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

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit cb654fb. Configure here.

Comment thread guides/use-workflows.mdx Outdated
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 28, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview May 28, 2026, 8:11 PM

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 28, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
testsignup415 🟢 Ready View Preview May 28, 2026, 8:17 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@ethanpalm ethanpalm requested a review from paaatrrrick May 29, 2026 15:49
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