* Bleeding edge documentation
@ 2018-06-20 4:00 swedebugia
2018-06-20 6:10 ` Nils Gillmann
0 siblings, 1 reply; 6+ messages in thread
From: swedebugia @ 2018-06-20 4:00 UTC (permalink / raw)
To: Guix-devel
[-- Attachment #1: Type: text/plain, Size: 332 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
[-- Attachment #2: Type: text/html, Size: 368 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bleeding edge documentation
2018-06-20 4:00 Bleeding edge documentation swedebugia
@ 2018-06-20 6:10 ` Nils Gillmann
2018-06-20 8:32 ` Ricardo Wurmus
0 siblings, 1 reply; 6+ messages in thread
From: Nils Gillmann @ 2018-06-20 6:10 UTC (permalink / raw)
To: swedebugia; +Cc: Guix-devel
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?
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bleeding edge documentation
2018-06-20 6:10 ` Nils Gillmann
@ 2018-06-20 8:32 ` Ricardo Wurmus
2018-06-20 8:44 ` Nils Gillmann
2018-06-20 14:39 ` Joshua Branson
0 siblings, 2 replies; 6+ messages in thread
From: Ricardo Wurmus @ 2018-06-20 8:32 UTC (permalink / raw)
To: Nils Gillmann; +Cc: Guix-devel
Nils Gillmann <ng0@n0.is> 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.
--
Ricardo
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bleeding edge documentation
2018-06-20 8:32 ` Ricardo Wurmus
@ 2018-06-20 8:44 ` Nils Gillmann
2018-06-20 14:39 ` Joshua Branson
1 sibling, 0 replies; 6+ messages in thread
From: Nils Gillmann @ 2018-06-20 8:44 UTC (permalink / raw)
To: Ricardo Wurmus; +Cc: Guix-devel, Nils Gillmann
Ricardo Wurmus transcribed 888 bytes:
>
> Nils Gillmann <ng0@n0.is> 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.
>
> --
> Ricardo
>
Ah, good to know. Thanks
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bleeding edge documentation
2018-06-20 8:32 ` Ricardo Wurmus
2018-06-20 8:44 ` Nils Gillmann
@ 2018-06-20 14:39 ` Joshua Branson
2018-06-20 15:12 ` Nils Gillmann
1 sibling, 1 reply; 6+ messages in thread
From: Joshua Branson @ 2018-06-20 14:39 UTC (permalink / raw)
To: guix-devel
Ricardo Wurmus <rekado@elephly.net> writes:
> Nils Gillmann <ng0@n0.is> 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.
>
> --
> Ricardo
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Bleeding edge documentation
2018-06-20 14:39 ` Joshua Branson
@ 2018-06-20 15:12 ` Nils Gillmann
0 siblings, 0 replies; 6+ messages in thread
From: Nils Gillmann @ 2018-06-20 15:12 UTC (permalink / raw)
To: Joshua Branson; +Cc: guix-devel
Joshua Branson transcribed 1.1K bytes:
> Ricardo Wurmus <rekado@elephly.net> writes:
>
> > Nils Gillmann <ng0@n0.is> 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.
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2018-06-20 15:12 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2018-06-20 4:00 Bleeding edge documentation swedebugia
2018-06-20 6:10 ` Nils Gillmann
2018-06-20 8:32 ` Ricardo Wurmus
2018-06-20 8:44 ` Nils Gillmann
2018-06-20 14:39 ` Joshua Branson
2018-06-20 15:12 ` Nils Gillmann
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/guix.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).