Date: Sat, 4 Dec 2021 00:30:33 +0100 From: Sergio Carlavilla <carlavilla@freebsd.org> To: Rocky Hotas <rockyhotas@firemail.cc> Cc: Pau Amma <pauamma@gundo.com>, "freebsd-doc@FreeBSD.org" <freebsd-doc@freebsd.org>, freebsd-translators@freebsd.org, jrm@ftfl.ca, =?UTF-8?Q?Fernando_Apestegu=C3=ADa?= <fernape@freebsd.org>, "Danilo G. Baio" <dbaio@freebsd.org> Subject: Re: FreeBSD Documentation Portal status and review request Message-ID: <CAFwocyNrDftR6VxQq68XLMZf=ha-sLfendfzw9Oh26NSiSG2aA@mail.gmail.com> In-Reply-To: <20211125115446.fly4ifz5q46axpzm@delpotro> References: <CAFwocyO9GEUXno%2BewzkEVkoE1Fx_14ChO7NwU=wW2hQeiA0OcQ@mail.gmail.com> <20211122221605.6yvfnuhpg75gthgy@delpotro> <10f9984820d1060cc3b9555f8b7b91f7@gundo.com> <20211125115446.fly4ifz5q46axpzm@delpotro>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAFwocyNrDftR6VxQq68XLMZf=ha-sLfendfzw9Oh26NSiSG2aA>