[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: [PATCH] Quick-start guide
From: |
Ludovic Courtès |
Subject: |
Re: [PATCH] Quick-start guide |
Date: |
Sun, 12 Jun 2016 22:46:10 +0200 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/24.5 (gnu/linux) |
Hi!
myglc2 <address@hidden> skribis:
> This is the correct goal, but the manual as it stands is problematic for
> first-time users for reasons such as: it's overwhelmingly copious;
> information is "shredded" into different sections; the is confusing
> terminology; finding one's way around is difficult; there is virtually
> no guidance of what to read first or how to proceed.
Woow, that’s a lot of room for progress. :-)
I think all of these issues need to be clarified and addressed.
The problem for me as a maintainer is that we don’t have a test suite
for the manual. So I cannot simply apply a big patch and run “make
check” to ensure that nothing “broke” in the manual. So I’m both
receptive and demanding here ;-), because it’s often the case that
editing the manual is more work than adding a couple of paragraphs here
and there.
> I see this patch as an attempt to address some of these difficulties.
Sure, my concern is about the duplication of information and additional
maintenance burden that ensues.
> I suggest we add a new "Getting Started" section between "Introduction"
> and "Installation". "Getting Started" should initially include a
> discussion of how to decide whether to install Guix or GuixSD and
> quick-start sections for each.
That sounds like a good idea. To begin with, would you like to propose
a “Guix Quick Start” section that we could put between the “Features”
and “Invoking ‘guix package’” sections?
Thanks,
Ludo’.
- [PATCH] Quick-start guide, yoosty, 2016/06/04
- Re: [PATCH] Quick-start guide, Ludovic Courtès, 2016/06/08
- Re: [PATCH] Quick-start guide, yoosty, 2016/06/11
- Re: [PATCH] Quick-start guide, yoosty, 2016/06/15
- Re: [PATCH] Quick-start guide, Ludovic Courtès, 2016/06/16
- Re: [PATCH] Quick-start guide, yoosty, 2016/06/24
- Re: [PATCH] Quick-start guide, Ludovic Courtès, 2016/06/24
Re: [PATCH] Quick-start guide, John Darrington, 2016/06/12