Skip to content

docs: Document mautic:email:sendwinner command for A/B test automation#294

Draft
promptless-for-oss wants to merge 2 commits intomautic:5.xfrom
Promptless:promptless/pr-15897-ab-testing-sendwinner-command
Draft

docs: Document mautic:email:sendwinner command for A/B test automation#294
promptless-for-oss wants to merge 2 commits intomautic:5.xfrom
Promptless:promptless/pr-15897-ab-testing-sendwinner-command

Conversation

@promptless-for-oss
Copy link
Copy Markdown

Open this suggestion in Promptless to view citations and reasoning process

Documents the new mautic:email:sendwinner CLI command introduced for A/B testing segment emails. This command sends the winning A/B test variant to remaining contacts after the test period ends. The documentation includes command usage, options, cron setup instructions, and describes what the command does.

Trigger Events

mautic/mautic PR #15897: feat: A/B testing for segment emails (migrated from Automation53)

Promptless Research (1 GitHub PR)

Agent Response

I've completed my review of PR #15897 and created a documentation suggestion.

Summary

PR #15897 introduces A/B testing for segment emails to Mautic 7, migrated from Automation53. After analyzing the changes, I identified one key developer-facing component that needs documentation:

Documentation Created

New section: "A/B test automation command" added to docs/plugin_extensions/emails.rst

This documents the new mautic:email:sendwinner CLI command, which:

  • Sends the winning A/B test variant to remaining contacts after the test period ends
  • Can process all pending A/B tests or a specific email via the --id option
  • Should be added to cron for automated A/B test completion

The documentation includes command usage examples, cron setup instructions, and explains what the command does step-by-step.

What I didn't document

  • Internal services (AbTestSettingsService, AbTestResultService, etc.) - These are internal implementation details, not developer-facing extension points
  • The existing A/B testing extension points - The current documentation for custom winner criteria (addAbTestWinnerCriteria(), DetermineWinnerEvent) remains accurate and unchanged by this PR
  • variant_entities.rst - This page is marked as needing a major update, but this PR doesn't provide enough new public APIs to justify filling it in

The suggestion is ready for your review when you're ready to look at the documentation changes.


Tip: Tell your friends working on non-commercial open-source projects to apply for free Promptless access at promptless.ai/oss ❤️

Signed-off-by: promptless-for-oss <promptless-for-oss@users.noreply.github.com>
Comment thread docs/plugin_extensions/emails.rst Outdated

.. vale on

The ``mautic:email:sendwinner`` command sends the winning A/B test variant to remaining Contacts in a Segment after the test period ends.
Copy link
Copy Markdown
Author

Choose a reason for hiding this comment

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

Citation: New mautic:email:sendwinner command introduced in app/bundles/EmailBundle/Command/SendWinnerEmailCommand.php. Command processes A/B test emails after the test delay period ends, determining winner and sending to remaining contacts.
View source

Signed-off-by: promptless-for-oss <promptless-for-oss@users.noreply.github.com>
@promptless-for-oss
Copy link
Copy Markdown
Author

I've added new changes to address this change request from the dashboard in commit 383c779

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.

1 participant