From nobody Thu Jul 6 16:02:05 2023 X-Original-To: dev-commits-doc-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Qxh9n3gbhz4lc7L for ; Thu, 6 Jul 2023 16:02:05 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Qxh9n3G1Sz3Hpf; Thu, 6 Jul 2023 16:02:05 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688659325; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=pTEgKhIak0qhFiR9ksN7izhTMOirmW+woGeJm/RxGkU=; b=W7Li+tRzB/3nVWqMuClMF5OFiZ/S2cjgzTy8cIOlA/GyC0St30ttxihBCPxjfZulO4CXIH FOknJtuLm9/ei7/I4SWAS4GScN7D7yw1P/seMCPVcGBZRRBFxemUVPPHVzYQjWM2bMVs5P RqSqoEDBErUO0qKQBrq4Cvt5UNhTgx+gpvO51LXJ4wzX2iKtrMWVhw6b3vKNCZ79f0Yc/G Klb74PU6uD6295dV1goqi70wdVRHEluY2aLUJtK0N1fL9HQOPpEsUgiy8bJpKVA7txUmUJ eFVIl60C0PYVBqOtddaS6wMjWmh0Ke6nMXhPeTI52TcboC5AMeNMmVHScmq76w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1688659325; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=pTEgKhIak0qhFiR9ksN7izhTMOirmW+woGeJm/RxGkU=; b=m0OSymg5/B/pcZksbrOhvCBrQp2EJiHY6vizg+QBesCxYnEs3mNP5T5cK4YZT3n0jxIJab fY907bXkVrY88a/XyEC9ySqT/2Pziby8MmMsaqFZLmHlUk6TN69feTVQGInADH7T5aLgX5 YvEAFW5GiXZgV7oMUJtOfi0Yu1MgdtU8xSHFUhuBXZgXPcNLh1Ey5RD15x1mgFwVs5Y42+ PnKVR/9HEfcEGReB0tzidz3BN4rq8dqsH98LN4uJDhnuI3jh5Stc0EjYTmEiaiNXxNhzZm KMgQFapPHxksQLgSw0UMthLhxf0tcuVdSYeq/hZqUG8yq9r//Cv3PmbYFLjaeA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1688659325; a=rsa-sha256; cv=none; b=x4f2T8qsKza8KUuXMts9XLApOvkvuEjrcc/S+TRS1D+nFFOIszVCMgdF8Yk+RvWJa+NkK1 ftHzWlOvxNc/xUYOwDqvrD9ej8cY1GI1W5yPGHTMhDCjFQc46sWy2oV+qgYu/bJ5MkyX8c Ex9n8vg9jFAwxVWYd8qtM3lWjngsANKMsLaEEcBszsMw3xEozm4uR/4SeMwHiUhNRBjllH P076CHTeCW4f20BHYncyXuIUzzTmL0Yc75VB/WIYEUvz1dgFs6mezs0tZV9LAKtXEArzxC D4Y4Gh459DXG8gB+kwMCoPnJE1WROhsMYLJ6PeoI05ST/1puUSqPvdSX4DE6YQ== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Qxh9n2LnQz136s; Thu, 6 Jul 2023 16:02:05 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.17.1/8.17.1) with ESMTP id 366G25nR049408; Thu, 6 Jul 2023 16:02:05 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.17.1/8.17.1/Submit) id 366G25mj049407; Thu, 6 Jul 2023 16:02:05 GMT (envelope-from git) Date: Thu, 6 Jul 2023 16:02:05 GMT Message-Id: <202307061602.366G25mj049407@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Lorenzo Salvadore Subject: git: bd0a6f54b7 - main - Status/2023Q2/doceng.adoc: Add report List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-doc-all@freebsd.org X-BeenThere: dev-commits-doc-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: salvadore X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: bd0a6f54b79f90acc5bd93b73e23fa4cecbb24c0 Auto-Submitted: auto-generated X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by salvadore: URL: https://cgit.FreeBSD.org/doc/commit/?id=bd0a6f54b79f90acc5bd93b73e23fa4cecbb24c0 commit bd0a6f54b79f90acc5bd93b73e23fa4cecbb24c0 Author: Fernando Apesteguía AuthorDate: 2023-07-06 15:32:19 +0000 Commit: Lorenzo Salvadore CommitDate: 2023-07-06 16:01:11 +0000 Status/2023Q2/doceng.adoc: Add report Approved by: dbaio (mentor, implicit) --- .../en/status/report-2023-04-2023-06/doceng.adoc | 102 +++++++++++++++++++++ 1 file changed, 102 insertions(+) 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 + +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 + + * link:https://reviews.freebsd.org/D40546[The Network chapter is being reworked] + +==== FreeBSD Website Revamp - WebApps working group + +Contact: Sergio Carlavilla + +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_)