From mboxrd@z Thu Jan 1 00:00:00 1970 From: L p R n d n Subject: Re: Communication and Design at Guix Date: Thu, 10 Jan 2019 13:09:48 +0100 Message-ID: References: <87k1jfuk26.fsf@gnu.org> <705CB66B-E8D5-4119-9F70-D429E1B174B2@pretty.Easy.privacy> <877efd1p56.fsf@gnu.org> 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]:35525) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ghYDc-0002OJ-5r for guix-devel@gnu.org; Thu, 10 Jan 2019 06:09:48 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ghYDb-0006qQ-B2 for guix-devel@gnu.org; Thu, 10 Jan 2019 06:09:48 -0500 Received: from mout01.posteo.de ([185.67.36.141]:52477) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ghYDb-0006oV-4S for guix-devel@gnu.org; Thu, 10 Jan 2019 06:09:47 -0500 Received: from submission (posteo.de [89.146.220.130]) by mout01.posteo.de (Postfix) with ESMTPS id EDE8316005D for ; Thu, 10 Jan 2019 12:09:40 +0100 (CET) Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 43b3DN1LzQz6tmK for ; Thu, 10 Jan 2019 12:09:39 +0100 (CET) In-Reply-To: <877efd1p56.fsf@gnu.org> ("Ludovic \=\?utf-8\?Q\?Court\=C3\=A8s\=22'\?\= \=\?utf-8\?Q\?s\?\= message of "Wed, 09 Jan 2019 22:45:25 +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: guix-devel@gnu.org Hello, Ludovic Court=C3=A8s writes: > 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 jus= t 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, thou= gh, > especially since Guix=E2=80=99 manual has cross-references to many other > manuals. That would be nice though. Even if consistency is enjoyable, I think the benefits of a nicely shaped and organised documentation easily beat what we could get from being consistent with non-Guix manuals. IMHO=20 GNU manuals are ok when you know what you're searching for, I find them unreadable. + I think they're intimidating for newcomers. :/=20=20 >> 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@lis= p=E2=80=9D Texinfo > bits. +1 > Thanks, > Ludo=E2=80=99. Thanks, Lprndn