From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?utf-8?Q?Ludovic_Court=C3=A8s?= Subject: Re: Communication and Design at Guix Date: Wed, 09 Jan 2019 22:45:25 +0100 Message-ID: <877efd1p56.fsf@gnu.org> References: <87k1jfuk26.fsf@gnu.org> <705CB66B-E8D5-4119-9F70-D429E1B174B2@pretty.Easy.privacy> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([209.51.188.92]:47006) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ghLfU-0003J5-AW for guix-devel@gnu.org; Wed, 09 Jan 2019 16:45:45 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ghLfS-0004La-FE for guix-devel@gnu.org; Wed, 09 Jan 2019 16:45:44 -0500 Received: from hera.aquilenet.fr ([185.233.100.1]:57360) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ghLfQ-0004EY-CU for guix-devel@gnu.org; Wed, 09 Jan 2019 16:45:41 -0500 In-Reply-To: <705CB66B-E8D5-4119-9F70-D429E1B174B2@pretty.Easy.privacy> (swedebugia's message of "Wed, 09 Jan 2019 07:11:28 +0100") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: swedebugia Cc: "guix-devel@gnu.org" , L p R n d n Hi swedebugia, swedebugia skribis: >>> By the way, I wanted to start working on the documentation.=20 >>> IMHO, it might benefit from a little graphical enhancement for >>> newcomers. The thing is that it's currently hosted on >>> gnu.org so it's probably not possible to modify the design. So I >>wanted >>> to ask, first, if that's something that would be welcome? What could >>be >>> the possibilities? And what would be the technical limitations? >> >>The HTML pages at gnu.org/s/guix/manual are generated from Texinfo.=20 >>The >>CSS there is shared with all the GNU manuals, which is nice for >>consistency. Ideally modifications of the CSS would be submitted to >>the >>GNU webmaster or bug-gnulib@gnu.org (I forgot which one). However, be >>aware that you may encounter misplaced conservatism if you take that >>route, so don=E2=80=99t lose your hair on it. [...] > What about guix.info? We can do whatever we want there I suppose and just= link to it from the gnu site. Well in general we can always do whatever we want. :-) I do think there=E2=80=99s value in presenting GNU manuals in a consistent way, though, especially since Guix=E2=80=99 manual has cross-references to many other manuals. > Talking about CSS and the manual I would like to add patens highlighting. > The chicken documentation has this (on mouse over) and it is really nice = to be able to see how complicated expressions are composed. Yes I=E2=80=99d love that too! It should be doable for the =E2=80=9C@lisp= =E2=80=9D Texinfo bits. Thanks, Ludo=E2=80=99.