From mboxrd@z Thu Jan 1 00:00:00 1970 From: Leo Famulari Subject: Re: [PATCH] Quick-start guide Date: Sat, 11 Jun 2016 13:49:55 -0400 Message-ID: <20160611174955.GA9544@jasmine> References: <8760tjkft8.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:59240) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1bBn36-00052q-AF for guix-devel@gnu.org; Sat, 11 Jun 2016 13:50:21 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1bBn33-0005It-5I for guix-devel@gnu.org; Sat, 11 Jun 2016 13:50:20 -0400 Content-Disposition: inline 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: yoosty@gmail.com Cc: guix-devel@gnu.org On Sat, Jun 11, 2016 at 06:43:21AM -0700, yoosty@gmail.com wrote: > Upon further reflection.. The Guix manual might not be an appropriate place > for such a guide. If the Guix manual isn't a good place for such a set of > instructions, do you have any suggestions for a location (blog, etc)? There is this useful wiki managed by Raymond Nicholson: https://gitlab.com/rain1/guix-wiki/wikis/home Although, I'd like to echo Ludovic's question, and also say that the goal of the manual is to be completely sufficient for first-timers and experienced users alike. I find the phenomenon of 3rd party wikis giving instructions on how to use some piece of software to be a dismaying "antipattern". And, the situation only gets worse as people send documentation to the 3rd party wiki instead of to the software project in questoin. So, please tell us of any specific shortcomings! It seems that you would prefer "System Installation" to begin with an outline?