From nobody Sun Nov 21 18:03:48 2021 X-Original-To: freebsd-translators@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 C082F188FFC0; Sun, 21 Nov 2021 18:04:07 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: from mail-yb1-xb36.google.com (mail-yb1-xb36.google.com [IPv6:2607:f8b0:4864:20::b36]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "smtp.gmail.com", Issuer "GTS CA 1D4" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Hxyvq4lJnz4vnl; Sun, 21 Nov 2021 18:04:07 +0000 (UTC) (envelope-from fernando.apesteguia@gmail.com) Received: by mail-yb1-xb36.google.com with SMTP id j2so7104581ybg.9; Sun, 21 Nov 2021 10:04:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=X9hrgOhYaYclssAz2yXHMEGU7XxEMvsi7x4yjSW5Y+Y=; b=Xwiiu4BZ5Y6BHz6AOXEEXWCpXecY9fc+37f7fq4IgNrtWwddGCkxf5sqvGQ5SWRLiQ eAJrv5ZMfKvSFuAd4au8sQNNSZYIwV1dMms0f0ldieEmX6ozbluOa24gGVXVtdj7mmS9 S/MXBAjlglp/T68l3e6Xx3hRLMcGg4KYdx6A/2023RT/yjkwo6/xWeVoq9jva9EW7EiL HBV04Uos1QTYF6LtW3DNUvrcTVmIQo+ODBvuU/YOH7EtnPKx4K/NkDSbs+zSjp08kgUB Fa/sSJ+uCOscdTyL05FosBUUZ1PA4AdOPvCOPExzr7j2PPzxtV4YjflnA0bHnV4Ltgx4 3j4A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=X9hrgOhYaYclssAz2yXHMEGU7XxEMvsi7x4yjSW5Y+Y=; b=qwZ3N2DDv8DZTRzdq1k5yUKxM22jiCUAVFN96nhde/QaZQ9Sx3jCWVgkcVOYfBreDy zuDy2MJKwL0BnUqZEkSx4q5JM2pEgAudRFn06lWW0AVlcq+HTUkVEYEEnNun04NI0f2S +Sm1hV/mfGfion1lePy4MtuCnnHjYq/lgaWwNQyRuMqpXwQJR9PvyBF2Ah9My4eHw52X CB8nrCf1eDfmkLc/BPCuwVSFDBvxXm3FJdkoqgublOVGtTQoaS4cnDlatESKGM0Rz8d3 Il7eeIB+I+GoMYINCfYqaZx2a1tiTZYY02v9J2kYURvxD+X4MCPTH39sXxc2QJB3Xeir lJ0g== X-Gm-Message-State: AOAM53341u+vXVNLD/iCRiHU/gPdjLW0A+xipKJZi15dfePNgu8zpEBw eqrakn8w4v80Wh+BsqoPBAEEqKFyeKA5JVkWdMF54Cg3RqI= X-Google-Smtp-Source: ABdhPJx8bgpYOdueuVfByqYoaObyNvPtWBaTwDM3iaXzyxbU88VpqLBwcpD1XiNoFIejA/qkz6bAzeyxC0b3l0qeVks= X-Received: by 2002:a25:ae07:: with SMTP id a7mr57014822ybj.364.1637517840883; Sun, 21 Nov 2021 10:04:00 -0800 (PST) List-Id: Translators List-Archive: https://lists.freebsd.org/archives/freebsd-translators List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-translators@freebsd.org X-BeenThere: freebsd-translators@freebsd.org MIME-Version: 1.0 References: In-Reply-To: From: =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= Date: Sun, 21 Nov 2021 19:03:48 +0100 Message-ID: Subject: Re: FreeBSD Documentation Portal status and review request To: Sergio Carlavilla Cc: "freebsd-doc@FreeBSD.org" , freebsd-translators@freebsd.org Content-Type: text/plain; charset="UTF-8" X-Rspamd-Queue-Id: 4Hxyvq4lJnz4vnl X-Spamd-Bar: ---- Authentication-Results: mx1.freebsd.org; none X-Spamd-Result: default: False [-4.00 / 15.00]; REPLY(-4.00)[]; TAGGED_FROM(0.00)[] X-ThisMailContainsUnwantedMimeParts: N On Sun, Nov 21, 2021 at 5:31 PM Sergio Carlavilla wrote: > > Dear FreeBSD community, > > A couple of months ago we added information about the new FreeBSD > Documentation Portal to the quarterly reports[1]. > > Well, at this time there's some things that need to be accomplished in the new > Documentation Portal. For example a local search using Algolia[2] as Hugo[3] or > AsciiDoctor[4] does. Algolia provides a free version for Open Source > projects[5]. > And the dark theme. > > Apart from that, you can see the new Documentation Portal here[6]. I > used my personal > VPS to deploy the documentation portal temporarily to show to the > community since I have problems with Gitlab and Docker. I didn't add > all the languages because the bandwidth and the disk size is very > limited. I have the cheapest VPS in Digital Ocean hehe. > > To summarize the changes you are going to find: > > - Completely new responsive design. Tested in FreeBSD and all other major OS. > - Removed Python from the dependencies. > - Removed the list of figures, tables and examples. > Do you think these lists are useful? In this case I'll restore it > using the AsciiDoctor API instead of Python. > > This change will not be as traumatic as the previous one, it will not > be necessary > to freeze the repository or change the technology used to build the > documentation. > The existing theme will "just" be modified. > > Please let me know your thoughts about this :) > I'm gonna send this message to the documentation and translators list > to reach more people. I like it very much. Thanks for working on this! A few details: The "community" link seems broken. It points to https://carlavilla.es/en/communit Font size at the fourth level of the titles seems a bit small to me. See the size difference between: 3.2.2. Maintainer responsibilities and 3.2.2.1. Keep your ports up to date ---> This looks a bit small in https://carlavilla.es/en/articles/contributing/ Can this be configured or do we rely on changing the font size in the browser? My last question is about Algolia. I'm not familiar with it. Why do we plan to use it? What does it provide that Google or Duck Duck Go do not? Thanks! > > The next steps will be: > > - Finish the dark theme (1 more week) > - Implement Algolia to use it for local searches (1 more week) > - Use mandoc to generate the manual pages > - Redesign the ports page > - Redesign of the FreeBSD main website > > Bye! > > [1] https://www.freebsd.org/status/report-2021-07-2021-09/#_freebsd_website_revamp_webapps_working_group > [2] https://www.algolia.com > [3] https://gohugo.io/ > [4] https://docs.asciidoctor.org/home/ > [5] https://www.algolia.com/for-open-source/ > [6] https://carlavilla.es >