From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Thompson, David" Subject: Re: Should we start a Guix users wiki? Date: Tue, 8 Sep 2015 08:40:58 -0400 Message-ID: References: <55EE0ADD.9050701@gmail.com> <87pp1tnsna.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 ([2001:4830:134:3::10]:58310) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZICr-0005MI-Ev for guix-devel@gnu.org; Tue, 08 Sep 2015 08:41:02 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ZZICo-0007F1-Ok for guix-devel@gnu.org; Tue, 08 Sep 2015 08:41:01 -0400 Received: from mail-yk0-f174.google.com ([209.85.160.174]:36097) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ZZICo-0007Em-KN for guix-devel@gnu.org; Tue, 08 Sep 2015 08:40:58 -0400 Received: by ykcf206 with SMTP id f206so115896432ykc.3 for ; Tue, 08 Sep 2015 05:40:58 -0700 (PDT) In-Reply-To: <87pp1tnsna.fsf@gnu.org> 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-bounces+gcggd-guix-devel=m.gmane.org@gnu.org To: =?UTF-8?Q?Ludovic_Court=C3=A8s?= Cc: guix-devel , Craig Barnes On Tue, Sep 8, 2015 at 5:54 AM, Ludovic Court=C3=A8s wrote: > Hi, > > Craig Barnes skribis: > >> Some time ago I asked on IRC about a guix users wiki. Someone suggest >> that I propose one here (sorry it's taken so long). >> >> I think that a wiki would be a good complement to the manual, which >> while quite complete, lacks exhaustive examples (which would be >> impractical). > > I have mixed feelings. There are several issues with a Wiki: one can > hardly know which version of the software it=E2=80=99s talking about (whe= reas > the installed Info pages of PDFs necessarily match the installed > version), and more importantly, it tends to be disorganized, > unmaintained, and often misleading. > > I would strongly encourage people to help fix the manual as a first > step. If information that a user deems useful is missing from the > manual, then it=E2=80=99s a bug. I=E2=80=99m willing to make it as simpl= e as possible > to fix the manual. But really, the manual should have all the examples > necessary for people to understand how to tweak things. +1 - Dave