From nobody Fri Dec 3 23:30:33 2021 X-Original-To: freebsd-doc@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 EDC5018B8778; Fri, 3 Dec 2021 23:30:45 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from smtp.freebsd.org (smtp.freebsd.org [96.47.72.83]) (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 "smtp.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J5Tb947Gxz4Yd6; Fri, 3 Dec 2021 23:30:45 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: from mail-ua1-f46.google.com (mail-ua1-f46.google.com [209.85.222.46]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "GTS CA 1D4" (verified OK)) (Authenticated sender: carlavilla) by smtp.freebsd.org (Postfix) with ESMTPSA id 6791BCFDB; Fri, 3 Dec 2021 23:30:45 +0000 (UTC) (envelope-from carlavilla@freebsd.org) Received: by mail-ua1-f46.google.com with SMTP id p2so8359602uad.11; Fri, 03 Dec 2021 15:30:45 -0800 (PST) X-Gm-Message-State: AOAM531exDa5psHxbN4jc16s7NmQRfAV1SballxBCwvGxZ4sNt3SRlh8 H6ulNEfcid2cintB/A00x91KHB4b70JWgwOfVLA= X-Google-Smtp-Source: ABdhPJx98GKw8JcoAl4a30YO1rigU2COLF/fvsFgGJjclM14w5mM2cHXUT7Q8fsQkwvokBXP5mQyTcUV698GTAn46P8= X-Received: by 2002:a67:f88e:: with SMTP id h14mr24699777vso.37.1638574245012; Fri, 03 Dec 2021 15:30:45 -0800 (PST) List-Id: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@freebsd.org MIME-Version: 1.0 References: <20211122221605.6yvfnuhpg75gthgy@delpotro> <10f9984820d1060cc3b9555f8b7b91f7@gundo.com> <20211125115446.fly4ifz5q46axpzm@delpotro> In-Reply-To: <20211125115446.fly4ifz5q46axpzm@delpotro> From: Sergio Carlavilla Date: Sat, 4 Dec 2021 00:30:33 +0100 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: FreeBSD Documentation Portal status and review request To: Rocky Hotas Cc: Pau Amma , "freebsd-doc@FreeBSD.org" , freebsd-translators@freebsd.org, jrm@ftfl.ca, =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= , "Danilo G. Baio" Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638574245; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=TZ5xgo6EMqCEEfSsLLwC4/3KO7mr+OdgP56CHTfnfVc=; b=iPRUmwBfbXugruiDlIG9W9O45fOf6h1cdvlpd0pXvCEBRRE6IsPzzpTYCtGjNrse/CGZzv vk2MUqTLd2/kAoiEJ6Iy5RSkl0cQK+TjiRsfWS79YSsvF0s0zcFHNk+TQgcdE2zzQsiGeA jFa0xhPq7mx2odb6w99cO6QykquUSxZ+EmfWWdjN0dK0fu08OUM1MkOdFkZWgqAvBMuuip FayTxgE6wFm3vEVMU8p9oVlBb7KjqMAhslhD4dUCeFut/UPVKWmUBTIhcLjp4IZZhEvlvK OqaJOV6kLOFKfqEyR5R/JBfybsoz5CjFVZ1loXtBeUJpseZhrFsePFnF4x4FjA== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638574245; a=rsa-sha256; cv=none; b=NLIvroVLrijgtpeEWiaX5sSYJPzLbASEJQOg/c84ejbytn1Ce3udRi2AQTRK3gXmu9fL4l sUYUQ/DoPQ4EV/IyfchPI+fkFTZmAtghYw8tUKH/nXnVil56FknGHoPC02pninAZUAjAE2 DW5bElhuRnlflXPgM1L19uaeHOkJ5SFaZdSy5Bo69cs/jhNVe7GRPYI2P2cuztBEZuP1uT g2v7gwLayhted4TDBLcs4V3bGZIO/JwhyB/GFGaYaE515jKF7RqNWF74OGIN4OBOOe7b5T JYaTcpHSQbbBJCiLiOpjND/zUZSsf55jb2CHCN4DDlut31ov2JvMrIS0e8PFeA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N Hi to all and thanks for your feedback :) I'm gonna answer all of you in this email. I'm gonna copy your name and then I'll answer you. And of course, sorry for the delay in the answer. I also uploaded a new version[1] with some improvements in the UX and the dark theme and high contrast theme. Fernando Apestegu=C3=ADa: > The "community" link seems broken. It points to https://carlavilla.es/en/= community This is correct, it's a bug, this should be removed and when this section it's ready activated again. > Font size at the fourth level of the titles seems a bit small to me. > See the size difference between: You're right, I'm gonna take a look at this and upload a new version with this fix. > 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? Before using this I'm gonna take a look at [2] and [3] and Baptiste Daroussin gave me the advice to take a look at this [4]. ---------------------------------------------------------------------------= ---------------------- Danilo: > We can let the trademark/copyright part be more formal and different > from the rest of the text. Yes, of course, maybe we can make the font bolder or increase the size. ---------------------------------------------------------------------------= ---------------------- Rocky Hotas: > - A dark theme would be very useful (and also very cool!). Just uploaded, also a high contrast theme too. Take a look and let me know your toughts :) > - The font for titles of chapters and sections is too much bold. > Lower level subsections, like `14.2.1. Preventing Logins', are instead ok= . Fernando also pointed out a problem with the headings too, I'll try to improve this. > - The whole page uses sans-serif fonts, except for the `Note', `Warning' = and similar panels. > This seems mismatched. Why not to use a sans-serif font also there? Are you referring to this[5]? > - There is a very high contrast with the background when using the black-= filled circles > with numbers in a code block. Maybe replace black with a different color? Are you referring to this[6]? > - The `Download PDF' and `Edit this page' links currently are not working= . Sorry, this is "normal", we will activate this functionality in the FreeBSD machines. > - The typewriter font used in-line and also in the emulated black screen = rectangles > is too little in comparison to the main text font. Can you please provide a link to an example of this? ---------------------------------------------------------------------------= ---------------------- Pau Amma: I just uploaded a dark theme and a high contrast theme. I'll try to create = a low contrast theme. ---------------------------------------------------------------------------= ---------------------- Joseph Mingrone: > One minor thing that I would miss would be the single page versions Yes, this is intencional, to save bandwidth, in the final version it will be available. Bye to all and thanks for your feedback, it's really appreciated :) [1] https://www.carlavilla.es/en/ [2] https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae [3] https://gist.github.com/cmod/5410eae147e4318164258742dd053993 [4] https://xapian.org/docs/omega/overview.html [5] https://carlavilla.es/en/books/fdp-primer/preface/#preface-notes [6] https://carlavilla.es/en/articles/rc-scripting/#rcng-dummy