////
Quarter:	2nd quarter of 2024
Prepared by:	fernape
Reviewed by:	
Last edit:	$Date$
Version:	$Id:$
////

=== Documentation Engineering Team

Link: link:https://www.freebsd.org/docproj/[FreeBSD Documentation Project] URL: link:https://www.freebsd.org/docproj/[] +
Link: link:https://docs.freebsd.org/en/books/fdp-primer/[FreeBSD Documentation Project Primer for New Contributors] URL: link:https://docs.freebsd.org/en/books/fdp-primer/[] +
Link: link:https://www.freebsd.org/administration/#t-doceng[Documentation Engineering Team] URL: link:https://www.freebsd.org/administration/#t-doceng[]

Contact: FreeBSD Doceng Team <doceng@FreeBSD.org>

The doceng@ team is a body to handle some of the meta-project issues associated with the FreeBSD Documentation Project; for more information, see link:https://www.freebsd.org/internal/doceng/[FreeBSD Doceng Team Charter].

==== Document changes

During this quarter multiple pieces of the documentation were updated including the removal of mentions to ports that were removed from the ports tree, typos, URL corrections, and asciidoc improvements.

These are three highlighted contributions in this quarter:

 * Best practices related to vendor import were documented. URL: link:https://cgit.freebsd.org/doc/commit/?id=fe494e72df138266f6da2b9170cf0215275a6aaf[]
 * A section about service jails was added to the handbook. URL: https://cgit.freebsd.org/doc/commit/?id=8f4754a9a6ee8f2503cfb68d14afa99b17729e7f[]
 * bhyve documentation was improved. URL: https://cgit.freebsd.org/doc/commit/?id=68cbd16c4e7c199cfdfb2b54110ad1470b4d7a2e[]

==== FreeBSD Translations on Weblate

Link: link:https://wiki.freebsd.org/Doc/Translation/Weblate[Translate FreeBSD on Weblate] URL: link:https://wiki.freebsd.org/Doc/Translation/Weblate[] +
Link: link:https://translate-dev.freebsd.org/[FreeBSD Weblate Instance] URL: link:https://translate-dev.freebsd.org/[]

===== Q2 2024 Status

* 17 team languages
* 214 registered users

9 new translators joined Weblate:

* BFR (de_DE)
* Elwood (de_DE)
* Freebsd-Freund (de_DE)
* MSantos (pt)
* SINF-KEN (fr_FR, nl_NL)
* aperechnev (ru)
* edsonwolf
* fdecunta (es_ES)
* wheatfox (zh_CN, zh_HANS)

===== Languages

* Chinese (Simplified) (zh-cn)	(progress: 7%)
* Chinese (Traditional) (zh-tw)	(progress: 3%)
* Dutch (nl) 			(progress: 1%)
* French (fr)			(progress: 1%)
* German (de)			(progress: 1%)
* Greek (el)			(progress: 1%)
* Indonesian (id)		(progress: 1%)
* Italian (it)			(progress: 5%)
* Korean (ko)			(progress: 32%)
* Norwegian (nb-no)		(progress: 1%)
* Persian (fa-ir)		(progress: 3%)
* Polish			(progress: 2%)
* Portuguese			(progress: 0%)
* Portuguese (pt-br)		(progress: 22%)
* Spanish (es)			(progress: 36%)
* Turkish (tr)			(progress: 2%)

We want to thank everyone that contributed, translating or reviewing documents.

And please, help promote this effort on your local user group, we always need more volunteers.

==== Packages maintained by DocEng

During this quarter the following work was done in packages maintained by
doceng@:

* package:textproc/docproj-legacy[]: Fix build with DBLATEX
* package:textproc/docproj-legacy[]: Fix poudriere warning
* package:textproc/rubygem-asciidoctor-epub3[]: Add missing run dependency
* package:www/gohugo[]: Update to 0.125.4

==== Open issues

There are 3 Open PRs in bugzilla assigned to doceng@:

 * link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=279815[279815 status reports: ERR_TOO_MANY_REDIRECTS]
 * link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=276923[276923 www/gohugo link error under poudriere]
 * link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=267274[267274 Please remove the zh-CN Handbook of the current FreeBSD website]

During this quarter doceng@ closed 3 PRs:

 * link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=278904[278904 misc/freebsd-doc-en: HTML should be single page]
 * link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=278732[278732 www/gohugo: Update to v125.5]
 * link:https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=278504[278504 textproc/rubygem-asciidoctor-epub3: A run-time dependency is missing for rubygem-asciidoctor-epub3 port]
