Re: Reference manual + tutorials

2018-06-03 Thread Ludovic Courtès
Hello, Ricardo Wurmus skribis: > Yes, this can work. It’s hard for me to imagine where one would put > prose that resembles a tutorial in our current manual. It currently > leans very heavily towards a reference manual, which discourages me from > adding elaborate examples. > > There’s also th

Re: Reference manual + tutorials

2018-05-29 Thread Ricardo Wurmus
Ludovic Courtès writes: > Hello! > > Ricardo Wurmus skribis: > >> It would be great to have both! I’d like the existing reference manual >> to remain as the canonical description of all features of Guix, so that >> an additional story-centered document (whether that be a dedicated >> section

Re: Reference manual + tutorials

2018-05-29 Thread Ludovic Courtès
Hello! Ricardo Wurmus skribis: > It would be great to have both! I’d like the existing reference manual > to remain as the canonical description of all features of Guix, so that > an additional story-centered document (whether that be a dedicated > section or a separate file) can guide readers

Re: Reference manual + tutorials

2018-05-29 Thread Ricardo Wurmus
Julien Lepiller writes: > Isn't the contributing section of the manual already a user story? It’s a meta story. We have no stories about the use of Guix itself. -- Ricardo

Re: Reference manual + tutorials

2018-05-29 Thread Julien Lepiller
How to begin, though…? :) The step 0 could be to copy and paste this post by Chris in a Texinfo document The step 1 could be to add a "post" about how to configure a desktop environment based on openbox along the lines of what this post proposes https://fedoramagazine.org/openbox-fedora/ And t

Re: Reference manual + tutorials (was: Customize GuixSD: Use Stock SSH Agent Everywhere!)

2018-05-29 Thread Catonano
2018-05-29 16:57 GMT+02:00 Ricardo Wurmus : > > Hi Catonano, > > >> > In this regard, I'd lie to suggest this talk, I think it's relevant > >> > https://archive.fosdem.org/2017/schedule/event/legacy_docs/ > >> > > >> > It'd be very useful for Guile too and God knows for how many more GNU > >> > pr