Skip to content

docs(mail): document SRS forwarding rewrite - #266

Merged
DavidePrincipi merged 4 commits into
mainfrom
feat-7741
Sep 25, 2026
Merged

DavidePrincipi merged 4 commits into
mainfrom
feat-7741

Conversation

@DavidePrincipi

Copy link
Copy Markdown
Member

This documents the Sender Rewriting Scheme (SRS) behavior added to mail forwarding, and rewrites the "User mailbox" section to use direct, active language instead of passive/impersonal phrasing. Related to NethServer/dev#7741.

  • Rewrite the "User mailbox" section with direct, active sentences ("Enable...", "Click...") instead of passive/impersonal phrasing.
  • Document the Sender Rewriting Scheme (SRS) rewrite applied to forwarded mail's envelope sender, including bounce/delivery-status-notification handling and a caveat about other message paths (archiving, Sieve rules) that can also see the rewritten address.
  • Replace the outdated warning about installing multiple Mail applications on the same node, since the Software Center already blocks that; clarify that port conflicts can still happen with other packages using the same ports.
  • Drop leftover "instance" wording elsewhere on the page.
  • Mirror all the above changes into the Italian translation.

How to test

  • Run yarn build to confirm there are no broken links or invalid MDX.
  • Run yarn start and review the "Mail" page (English and Italian) for wording and formatting.

🤖 Generated with Claude Code

Rephrase the User mailbox section in direct, active voice, and
document the Sender Rewriting Scheme (SRS) rewrite that mail
forwarding now applies to outgoing envelope senders. Mirror the same
changes into the Italian translation.

Assisted-by: Claude:claude-sonnet-5
Software Center already blocks a second Mail install on the same
node, so replace the outdated warning about multiple instances with
a note about port conflicts from other packages or services. Also
drop remaining "instance" wording elsewhere in the page, mirrored
into the Italian translation.

Assisted-by: Claude:claude-sonnet-5
@github-actions

github-actions Bot commented Sep 22, 2026 •

Copy link
Copy Markdown
Contributor
PR Preview Action v1.8.1
Preview removed because the pull request was closed.
2026-09-25 10:19 UTC

@DavidePrincipi
DavidePrincipi marked this pull request as draft September 22, 2026 16:25
@DavidePrincipi
DavidePrincipi marked this pull request as ready for review September 23, 2026 07:35

@stephdl stephdl left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

SRS content checks out against the running module on a live install. The new note on multiple Mail applications is right too, build-images.sh carries org.nethserver.max-per-node=1.

One sentence is wrong in both languages. Left inline.

Also, the description says Italian was mirrored, but lines 92 and 94 kept the old phrasing while their English counterparts changed.

Comment thread docs/administrator-manual/applications/mail.md Outdated
Address review feedback from stephdl on PR #266:
- Fix leftover Italian sentences for disabling a mailbox and editing
  it, to match the direct English phrasing.
- Fix the bounce/DSN sentence in both languages: only bounces and
  DSNs are addressed to the rewritten SRS0 envelope address (never
  ordinary replies, which follow From:), and the decoded address is
  the original external sender, not a local mailbox.
@DavidePrincipi

Copy link
Copy Markdown
Member Author

Merge after Mail 1.9 release... NethServer/dev#7741

@DavidePrincipi
DavidePrincipi merged commit 38ca720 into main Sep 25, 2026
2 checks passed
@DavidePrincipi
DavidePrincipi deleted the feat-7741 branch September 25, 2026 10:18
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.

3 participants