Created attachment 271568 [details] books/fdp-primer: document generation of .po files As answered by Vladlen Popolitov in bug #295678, comment #3, *.po files are generated by Weblate every night. There is no need to edit/regenerate them manually when editing the original english version of the documentation. Document it in po-translations chapter.
A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/doc/commit/?id=64b3126c0db9dcc8cf9a2f003b3a52dbb76a7fd1 commit 64b3126c0db9dcc8cf9a2f003b3a52dbb76a7fd1 Author: Alexey Shuvaev <bugsbeastie@gmail.com> AuthorDate: 2026-06-26 20:15:24 +0000 Commit: Benedict Reuschling <bcr@FreeBSD.org> CommitDate: 2026-06-26 20:22:33 +0000 fdp-primer: Mention that .po files are generated nightly There is no need to generate the .po files manually as they are generated every night. Describe this fact in the PO translations chapter. PR: 295901 Event: Halifax Hackathon 202606 Location: Back in my old chair .../content/en/books/fdp-primer/po-translations/_index.adoc | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-)
Thank you for the report and the attached patch. I've committed it just now. I close the PR now.
Created attachment 272278 [details] [PATCH] fdp-primer: Mention that .po files are generated quarterly (In reply to Benedict Reuschling from comment #2) Thank you for commiting the (wrong :) patch! I have updated the patch to reflect the correct information as from the bug #295678, comment #5. Note, that my change is trying to answer a simple question of english version contributor, who is responsible for the re-generation of an english *.po file that is located next to *.adoc file? The answer is NOT the contributor, but one of the DOCENG committers! Concerning bug #295678, comment #6, that PO-translation section is obsolete: I disagree! It is the only section that explains how the translation works behind the scenes. It explains how Weblate is incorporated into the workflow. I cannot find a better place to put the information about *.PO files!
Re-opening the PR with the new patch.