Wireshark-dev: [Wireshark-dev] Persian (Farsi) translation of the Wireshark User's Guide 5.1.0

Date: Thu, 12 Nov 2026 10:10:45 -0800
Hello Wireshark developers,

My name is Arian Ahmadi. I have completed a full Persian (Farsi)
translation of the Wireshark User's Guide, based on version 5.1.0, and
I am writing to ask how the project would prefer to receive it — or to
point people to it.

The translation is complete, not a partial draft: the Preface, all 12
chapters, Appendices A–D, and the license section, including all 207
figures. It is published as a right-to-left website with a Persian
typeface (Vazirmatn), and you can read it here:

https://fa-userguide-wireshark.arianahmadi27.workers.dev/

A few notes on how it was done:

- **Fidelity:** the structure mirrors the English guide exactly — same
chapters, order, and sectioning — and every page states the English
version it is based on (5.1.0).
- **Terminology:** menu items and dialog labels follow the existing
Persian Qt translation on Transifex where one exists. Protocol names,
display filter expressions, and protocol field names remain in
English, as in the original.
- **Format for review:** the website is built from Markdown sources,
and I have additionally prepared a sample of the translation in the
guide's own AsciiDoc format — the Preface, Chapter 1, and Chapter 4,
using the original wsug_src file names, structure, and anchors — so
your documentation maintainers can judge how it would fit the official
sources. I am happy to send those files directly, or give a reviewer
read-only access to the (private) source repository.
- **Maintenance:** I intend to keep the translation in step with new
stable releases of the guide, and the English guide remains the
authoritative text wherever the two differ.

I have read the Translations page on the wiki and I understand the
project's concerns about translated documentation — the maintenance
burden on a small community, and the risk of incomplete translations.
I have tried to answer both by finishing the whole guide before
writing to you, and by committing to maintain it myself. I also
understand that Persian is right-to-left and that the current
documentation toolchain is built for left-to-right output, so I am not
assuming that in-tree hosting is straightforward, and I am not asking
you to commit to it.

What I would appreciate is your guidance on the route you prefer:

1. If there is interest in an officially hosted or in-tree Persian
guide in the future, what format and review process would you like me
to follow, starting from the AsciiDoc sample?
2. If that is not practical, would you be open to listing or linking
the site as a community translation — for example from the wiki's
Translations page or the documentation page?
3. Are there any requirements you would like me to follow — licensing
notices, attribution, or a disclaimer stating that this is an
unofficial community translation?

Thank you for Wireshark, and for taking the time to read this. I would
be glad to hear any feedback on the translation itself as well.

Best regards,
Arian Ahmadi
GitHub: AlefAhmadi