[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Reference manual + tutorials (was: Customize GuixSD: Use Stock SSH Agent
From: |
Ricardo Wurmus |
Subject: |
Reference manual + tutorials (was: Customize GuixSD: Use Stock SSH Agent Everywhere!) |
Date: |
Tue, 29 May 2018 16:57:17 +0200 |
User-agent: |
mu4e 1.0; emacs 25.3.1 |
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
>> > projects
>>
>> Could you please summarize the key points and how they apply to this
>> discussion?
>>
>
>
> Sure ! Thanks for asking ! 😃
>
> I think a good starting point is this picture
> https://files.mastodon.social/media_attachments/files/003/855/604/original/b02a794729c184ad.png
[…]
Thank you for the summary!
I think that both styles are important. A reference manual is great
when looking up information and to figure out uncommon workflows. It’s
also good to have a single section that describes all features of a
tool, which otherwise would have to be extracted from user stories.
Having a document that is centered around user stories is also very
useful, as they make it easier for readers to see their own needs in
them and find the appropriate recipe that leads them to a solution more
quickly.
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 to more information if
they might need it.
How to begin, though…? :)
--
Ricardo
- Customize GuixSD: Use Stock SSH Agent Everywhere!, Ludovic Courtès, 2018/05/26
- Re: Customize GuixSD: Use Stock SSH Agent Everywhere!, Pierre Neidhardt, 2018/05/28
- Re: Customize GuixSD: Use Stock SSH Agent Everywhere!, Ricardo Wurmus, 2018/05/28
- Re: Customize GuixSD: Use Stock SSH Agent Everywhere!, Catonano, 2018/05/29
- Re: Customize GuixSD: Use Stock SSH Agent Everywhere!, Ricardo Wurmus, 2018/05/29
- Re: Customize GuixSD: Use Stock SSH Agent Everywhere!, Catonano, 2018/05/29
- Reference manual + tutorials (was: Customize GuixSD: Use Stock SSH Agent Everywhere!),
Ricardo Wurmus <=
- Re: Reference manual + tutorials (was: Customize GuixSD: Use Stock SSH Agent Everywhere!), Catonano, 2018/05/29
- Re: Reference manual + tutorials, Julien Lepiller, 2018/05/29
- Re: Reference manual + tutorials, Ricardo Wurmus, 2018/05/29
- Re: Reference manual + tutorials, Ludovic Courtès, 2018/05/29
- Re: Reference manual + tutorials, Ricardo Wurmus, 2018/05/29
Re: Customize GuixSD: Use Stock SSH Agent Everywhere!, Divan Santana, 2018/05/28