docs: Document the basic single-Email cloning workflow

[promptless-for-oss]

Open this suggestion in Promptless to view citations and reasoning process

Adds a "Cloning Emails" section to the Email docs covering the basic single-Email clone workflow (down arrow next to Schedule on the Email detail view, then Clone), which produces an editable copy prefilled with the original content and settings. Fills a pre-existing docs gap identified by @adiati98 in PR #717 review; split into its own PR to keep PR #717 scoped to the Clone-with-translations-and-variants feature (source PR mautic/mautic#16131).

---

Tip: Sort by Shortest Review in the Dashboard to find quick wins ⚡

[adiati98]

@promptless-for-oss please address the suggestions.

[promptless-for-oss]

Thanks for the review @adiati98 — I've updated the PR to address all three points:

1. Both clone entry points documented. The "Cloning Emails" section now covers the two ways to clone: from the Email listing (three-dots icon next to the Email's name → Clone) and from the Email detail view (down arrow next to Schedule → Clone). Avoided calling it the 'main' page.
2. Nesting. "Clone with translations and variants" is now a subsection of "Cloning Emails" (demoted its heading level accordingly).
3. Vale directives. Wrapped the "Cloning Emails" heading in .. vale off / .. vale on, consistent with the adjacent heading.

Ready for another look.

[adiati98]

@promptless-for-oss please address the suggestions.

[promptless-for-oss]

Thanks for the review @adiati98 — I've addressed both points:

1. Restructured the two clone entry points with images. The "Cloning Emails" section now breaks out each entry point with its own numbered sub-steps and an embedded screenshot:

   • From the Email listing → three-dots icon next to the checkbox → Options menu → Clone, followed by email_overview_clone.png.
   • From the Email detail view → down arrow next to Schedule → Clone, followed by email_clone.png.

   Both images are added under docs/channels/images/emails/ with the exact names you requested and referenced via the .. image:: directive (matching the sibling email_clone_translations_variants.png usage). Alt text is descriptive and doesn't start with "screenshot of":

   • "Options menu open on an Email row in the Email listing, with Clone highlighted."
   • "Expanded menu next to the Schedule button on the Email detail view, with Clone highlighted."

2. Reworded the permission note to your exact text: "Cloning requires permission to create Emails. If you don't have the permission, the Clone option doesn't appear."

Ran Vale on the changed file — 0 errors, no new findings. Ready for another look.

[adiati98]

/aside @escopecz, I just noticed we don't have any docs about cloning an email. Can you help in reviewing the content here?

If this is good to go, I'll backport this to other branches. I believe since 5.2 we already have this feature with the same ability, right?

Thanks!

[escopecz]

Reads good 👍

[adiati98]

@promptless-for-oss please address the suggestions.

[promptless-for-oss]

@adiati98 Thanks for the review — I've applied your suggestions and pushed the update.

The "From the Email detail view" sub-step now reads:

#. Click the down arrow button next to Schedule to open the Options menu.

This matches the parallel "From the Email listing" step. Ready for another look.

[adiati98]

@promptless-for-oss please create a PR to apply the changes here for updating 7.1, 7.0, 6.0, and 5.2 branches with below details:

• Only add the "Cloning Emails" section (the subsection is not part of the feature in other branches).
• Exclude the PNG images.
• Keep the image templates in the RST. I'll provide the PNG images later on for each PR.

[promptless-for-oss]

@adiati98 Done! I've created a separate backport PR for each of the requested branches, applying the changes as you specified:

• Only the Cloning Emails section is added (the "Clone with translations and variants" subsection is excluded).
• The PNG images are excluded, but the .. image:: template directives are kept in the RST so you can drop in the images per PR later.

Branch	Docs PR
7.1	PR #828
7.0	PR #829
6.0	PR #830
5.2	PR #831

Let me know if you'd like any adjustments.