From mboxrd@z Thu Jan 1 00:00:00 1970 From: myglc2 Subject: bug#22546: Download-Page is "hiding" what the options actually are Date: Mon, 15 Feb 2016 11:54:35 -0500 Message-ID: <877fi56his.fsf@gmail.com> References: <877figuw1y.fsf@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:47878) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aVMQZ-0000qo-JO for bug-guix@gnu.org; Mon, 15 Feb 2016 11:55:12 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aVMQQ-0000N6-A7 for bug-guix@gnu.org; Mon, 15 Feb 2016 11:55:07 -0500 Received: from debbugs.gnu.org ([208.118.235.43]:49596) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aVMQQ-0000MC-79 for bug-guix@gnu.org; Mon, 15 Feb 2016 11:55:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84) (envelope-from ) id 1aVMQP-0004AU-R5 for bug-guix@gnu.org; Mon, 15 Feb 2016 11:55:01 -0500 Sender: "Debbugs-submit" Resent-Message-ID: In-Reply-To: <877figuw1y.fsf@gnu.org> ("Ludovic \=\?utf-8\?Q\?Court\=C3\=A8s\=22'\?\= \=\?utf-8\?Q\?s\?\= message of "Sun, 07 Feb 2016 21:04:09 +0100") List-Id: Bug reports for GNU Guix List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org Sender: bug-guix-bounces+gcggb-bug-guix=m.gmane.org@gnu.org To: 22546@debbugs.gnu.org Cc: mls.robin.vobruba@gmail.com ludo@gnu.org (Ludovic Court=C3=A8s) writes: > Robin Vobruba skribis: > >> Being new to Guix, i went to the Download page: >> https://www.gnu.org/software/guix/download/ >> >> immediately saw the 3 big options >> read their title/names >> was confused what the difference might be between "GuixSD" and "Guix Bin= ary" >> could not find anything inside these 3 option's boxes that would help me >> read the text below them >> read the text above them >> finally understood that the first option is the OS, and the second is on= ly >> the packag-manager > > I think I=E2=80=99ll have to disagree. :-) > > For each option there=E2=80=99s a line right below the title saying what = this > is. I=E2=80=99m no expert in =E2=80=9Cinformation architecture=E2=80=9D = but I=E2=80=99m under the > impression that there=E2=80=99s little margin for improvement. You are too close to Guix to appreciate this user's confusion. > More importantly, I think that someone who cannot be bothered to read > this will not install the thing at all since installing requires you to > read the much longer installation instructions. It is a mistake to think this way.=20 During the first few moments of checking out Guix a user is looking for clues about how well "wrapped" it is. She is "using" your web site. If the experience of using your web site is difficult it signals that the software is difficult. Is this what you want? > Of course we want them to be as small as possible, but I don=E2=80=99t th= ink > that=E2=80=99ll be a single line anytime soon. The Guix web page and doc are very beautiful and detailed. But they do not clearly convey the relationship between Guix and GuixSD. This is why you have had to use so many puzzeling words on the download page. I have drawn two diagrams that illustrate and address this issue. They are posted it on gmane.comp.gnu.guix.devel under the subject 'Guix vs GuixSD'. I suggest that you discuss the diagrams and agree on a top-level diagram that explains the Guix-verse. Once you have that, you can use that diagram on the download page to make download choices easy.