From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nils Gillmann Subject: Re: Bleeding edge documentation Date: Wed, 20 Jun 2018 15:12:55 +0000 Message-ID: <20180620151255.sbknsbcsdhdy2ruq@abyayala> References: <20180620061010.3kfxbdhdeun7ggb5@abyayala> <87r2l1uac3.fsf@elephly.net> <87zhzpo72r.fsf@fastmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:55324) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fVemS-0003ry-UE for guix-devel@gnu.org; Wed, 20 Jun 2018 11:12:22 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fVemR-0007Dg-Ny for guix-devel@gnu.org; Wed, 20 Jun 2018 11:12:20 -0400 Received: from conspiracy.of.n0.is ([2a01:4f8:1c0c:7ad0::1]:53182) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fVemR-00079e-Ep for guix-devel@gnu.org; Wed, 20 Jun 2018 11:12:19 -0400 Content-Disposition: inline In-Reply-To: <87zhzpo72r.fsf@fastmail.com> 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: Joshua Branson Cc: guix-devel@gnu.org Joshua Branson transcribed 1.1K bytes: > Ricardo Wurmus writes: > > > Nils Gillmann writes: > > > >> swedebugia transcribed 1.0K bytes: > >>> Hi > >>> > >>> I would like to have a continously updated documentation for guix on the webpage in addition to the release documentation. > >>> > >>> I'm trying to read up on guix and the guix.texi file is hard to handle on a mobile device and it is quite cumbersome. > >>> > >>> The 0.14 docs are now heavily outdated in my opinion. > >>> -- > >>> Cheers Swedebugia > >> > >> This is due to gnu.org using CVS and with every release we have > >> to upload the documentation by hand. > >> Instead of moving the entire webpage out of gnu.org (which has > >> been proposed before), why not create docs.guixsd.org and > >> use that for updated documentation material? > > > > We have applied for a gnu.org subdomain a couple of weeks ago, but > > progress is slow. The goal is to move to infrastructure that we can > > more easily (and automatically) update. > > May I ask what are some of the other infrastructure options are? > notabug? I'm sure you'll guys will choose a good one, but I'm just curious. This is about choosing a static webview for the documentation, not a convenience solution which renders them -- which notabug doesn't do by the way. The documentation you view on gnu.org is just checked in into CVS.