How Mautic pairs Promptless with human review to catch up on docs

说明与用途

Mautic 使用 Promptless 自动生成文档更新，随后由开发者和教育团队审核，将交付时间从 98 天缩短到 27 天，缩小代码与文档之间的差距。

问题

Documentation lagged behind code releases because volunteers had to manually write updates, causing outdated user and developer docs.

结果

In four months Promptless produced 129 merged docs PRs, a 3.5× faster turnaround than manual updates, and closed a two‑version gap between code and docs.

工作流

• 1. Developer opens a code PR in mautic/mautic.
• 2. Promptless monitors the PR and drafts a corresponding docs PR as a draft.
• 3. If the code PR is merged, Promptless marks the docs PR as ready for review.
• 4. Developers review the draft to ensure alignment with code changes.
• 5. The Education Team reviews grammar, style, and wording.
• 6. Once approved, the docs PR is merged.
• 7. Promptless learns from corrections to improve future drafts.

证据

Docs updates made by Promptless took an average of 27 days from code merge to docs merge. Docs written by hand averaged 98 days.

来源

Promptless once drafted a new section for an updated dropdown menu, but the improved labels already made the feature self‑explanatory, so the section would have only duplicated existing content.

来源