aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFernando ApesteguĂ­a <fernape@FreeBSD.org>2023-07-06 15:32:19 +0000
committerLorenzo Salvadore <salvadore@FreeBSD.org>2023-07-06 16:01:11 +0000
commitbd0a6f54b79f90acc5bd93b73e23fa4cecbb24c0 (patch)
tree64df3021cef6af23a227309f7fe6de16e6890c6b
parentb113509f32da681db41fd60594b723c13334df8e (diff)
downloaddoc-bd0a6f54b79f90acc5bd93b73e23fa4cecbb24c0.tar.gz
doc-bd0a6f54b79f90acc5bd93b73e23fa4cecbb24c0.zip
Status/2023Q2/doceng.adoc: Add report
Approved by: dbaio (mentor, implicit)
-rw-r--r--website/content/en/status/report-2023-04-2023-06/doceng.adoc102
1 files changed, 102 insertions, 0 deletions
diff --git a/website/content/en/status/report-2023-04-2023-06/doceng.adoc b/website/content/en/status/report-2023-04-2023-06/doceng.adoc
new file mode 100644
index 0000000000..fa6e336069
--- /dev/null
+++ b/website/content/en/status/report-2023-04-2023-06/doceng.adoc
@@ -0,0 +1,102 @@
+////
+Quarter: 2nd quarter of 2023
+Prepared by: fernape
+Reviewed by: dbaio, carlavilla
+Last edit: $Date: 2023-06-25 15:11:08 +0200 (Sun, 25 Jun 2023) $
+Version: $Id: doceng-2023-2nd-quarter-status-report.adoc 415 2023-06-25 13:11:08Z carlavilla $
+////
+
+=== Documentation Engineering Team
+
+Link: link:https://www.freebsd.org/docproj/[FreeBSD Documentation Project] URL: link:https://www.freebsd.org/docproj/url[] +
+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/url[] +
+Link: link:https://www.freebsd.org/administration/#t-doceng[Documentation Engineering Team] URL: link:https://www.freebsd.org/administration/#t-docengurl[]
+
+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].
+
+During the last quarter:
+
+* fernape@ has been appointed as a new Doceng team member.
+* The package:www/gohugo[] port maintainership has been transfered to doceng@ since it is a critical part of our documentation infrastructure.
+This was agreed with the former maintainer.
+* Improvements to the translation workflow (described in the following sections).
+
+==== Porter's Handbook:
+
+The missing link:https://cgit.freebsd.org/doc/commit/?id=634a34b7bb37650e4f8fcbea9fd7428b3f5b911a[Uses=nextcloud has been documented.]
+
+==== FDP Primer:
+
+* A new chapter focusing on Weblate has been recently added to the link:https://docs.freebsd.org/en/books/fdp-primer/weblate/[FreeBSD Documentation Project Primer for New Contributors book].
+This comprehensive chapter provides step-by-step guidance on joining the FreeBSD translators team, both for translating online on Weblate and offline.
+It offers valuable insights and practical suggestions for efficient translation, proofreading, and testing processes.
+Furthermore, this chapter equips contributors with the necessary knowledge to formally submit their translations to the documentation repository, ensuring a seamless integration of their work.
+
+==== 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/Weblateurl[] +
+Link: link:https://translate-dev.freebsd.org/[FreeBSD Weblate Instance] URL: link:https://translate-dev.freebsd.org/url[]
+
+===== Q2 2023 Status
+
+* 15 languages
+* 183 registered users
+* link:https://lists.freebsd.org/archives/freebsd-translators/2023-April/000111.html[New Weblate server]
+
+The FreeBSD Weblate instance now operates on a dedicated server, significantly improving its speed and enhancing the efficiency of translation work.
+Our heartfelt appreciation goes to ebrandi@ for providing this hardware upgrade.
+
+===== 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%)
+* Indonesian (id) (progress: 1%)
+* Italian (it) (progress: 5%)
+* Korean (ko) (progress: 32%)
+* Norwegian (nb-no) (progress: 1%)
+* Persian (fa-ir) (progress: 3%)
+* Polish (progress: 1%)
+* Portuguese (pt-br) (progress: 22%)
+* Sinhala (si) (progress: 1%)
+* Spanish (es) (progress: 33%)
+* 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.
+
+==== FreeBSD Handbook working group
+
+Contact: Sergio Carlavilla <carlavilla@FreeBSD.org>
+
+ * link:https://reviews.freebsd.org/D40546[The Network chapter is being reworked]
+
+==== FreeBSD Website Revamp - WebApps working group
+
+Contact: Sergio Carlavilla <carlavilla@FreeBSD.org>
+
+Working group in charge of creating the new FreeBSD Documentation Portal and redesigning the FreeBSD main website and its components.
+FreeBSD developers can follow and join the working group on the FreeBSD Slack channel #wg-www21.
+The work will be divided into four phases:
+
+. Redesign of the Documentation Portal
++
+Create a new design, responsive and with global search. (_Complete_)
+
+. Redesign of the Manual Pages on web
++
+Scripts to generate the HTML pages using mandoc. (_Complete_)
+Public instance on https://man-dev.FreeBSD.org
+
+. Redesign of the Ports page on web
++
+Ports scripts to create an applications portal. (_Work in progress_)
+
+. Redesign of the FreeBSD main website
++
+New design, responsive and dark theme. (_Work in progress_)