From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ricardo Wurmus Subject: Re: Communication and Design at Guix Date: Thu, 10 Jan 2019 15:34:39 +0100 Message-ID: <87r2dk4m4g.fsf@elephly.net> 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]:37781) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ghbQL-00086q-IZ for guix-devel@gnu.org; Thu, 10 Jan 2019 09:35:10 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ghbQK-00009D-Ly for guix-devel@gnu.org; Thu, 10 Jan 2019 09:35:09 -0500 Received: from sender-of-o53.zoho.com ([135.84.80.218]:21826) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1ghbQK-00008j-Cl for guix-devel@gnu.org; Thu, 10 Jan 2019 09:35:08 -0500 In-reply-to: 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: L p R n d n Cc: guix-devel@gnu.org L p R n d n writes: >>> What about guix.info? We can do whatever we want there I suppose and ju= st 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, tho= ugh, >> 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 > GNU manuals are ok when you know what you're searching for, I find them > unreadable. + I think they're intimidating for newcomers. :/ It=E2=80=99s fine to deviate from the consistent style. We do that already= for the style sheet that=E2=80=99s used for our HTML documentation. Compare th= is: https://www.gnu.org/software/sharutils/manual/html_node/index.html with this: https://www.gnu.org/software/guix/manual/en/html_node/index.html It=E2=80=99s fine to change our style sheet, but let=E2=80=99s stay with Te= xinfo. -- Ricardo