From mboxrd@z Thu Jan 1 00:00:00 1970 From: Chris Marusich Subject: Re: website: say what Guix is at the very top Date: Sat, 27 Jan 2018 16:33:17 -0800 Message-ID: <87fu6qbz5e.fsf@gmail.com> References: <87inc0gzoz.fsf@elephly.net> <87efmixtl7.fsf@gmail.com> <87h8rb1grv.fsf@gnu.org> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:34471) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1efauV-0005Hu-P1 for guix-devel@gnu.org; Sat, 27 Jan 2018 19:33:29 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1efauU-00006m-Kn for guix-devel@gnu.org; Sat, 27 Jan 2018 19:33:27 -0500 In-Reply-To: <87h8rb1grv.fsf@gnu.org> ("Ludovic \=\?utf-8\?Q\?Court\=C3\=A8s\=22'\?\= \=\?utf-8\?Q\?s\?\= message of "Wed, 24 Jan 2018 15:19:00 +0100") List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: Ludovic =?utf-8?Q?Court=C3=A8s?= Cc: guix-devel@gnu.org --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable ludo@gnu.org (Ludovic Court=C3=A8s) writes: > Hello, > > Chris Marusich skribis: > >> Ricardo Wurmus writes: >> >>> Hi Guix, >>> >>> on the website it starts right away with a list of features: >>> =E2=80=9CLiberating=E2=80=9D, =E2=80=9CDependable=E2=80=9D, and =E2=80= =9CHackable=E2=80=9D. But what is this thing >>> called Guix? >>> >>> We should add a very short paragraph above that list to say what Guix >>> and GuixSD are. >>> >>> What do you think? >> >> How is Guix different from other package managers? Why is it better? > > That=E2=80=99s what Liberating (free software), Dependable (transactional, > etc.), Hackable (it=E2=80=99s a Scheme API) tries to convey. > > The hope was that by reading these 3 items people could tell how it > differs from APT/dpkg, Conda, or Nix. To be honest, I really like the current list of 3 items. I think it's a good "marketing" front page, even if perhaps it doesn't provide a complete answer of what Guix is. What do you think about making these minor changes to the website (see attached). >> Perhaps the best way to do that would be to write a problem statement. >> Instead of explaining what Guix is, explain what problems Guix solves. >> The first chapter of Eelco Dolstra's Ph. D. thesis [1] did a fantastic >> job of explaining what problems Nix solves, and by the end of that >> chapter, I was really excited to learn more about Nix (and Guix) and try >> it out. In particular, the list of problems with the state of the art >> in section 1.3 "Motivation" and the list of solutions that Nix offers in >> section 1.5 "Contributions" were particularly concise and convincing. >> Maybe we can aim for something similar on our Guix website? > > The =E2=80=9CIntroduction=E2=80=9D and =E2=80=9CFeatures=E2=80=9D section= s of the manual aim to achieve > that goal, but in a =E2=80=9Cconstructive=E2=80=9D way (stating what prop= erties it has, > rather than what properties other solutions lack.) However, I think > it=E2=80=99s not that concise and it=E2=80=99s quite technical, so I=E2= =80=99d keep that in the > manual rather than on the front page. > > Thoughts? I agree. Our manual is great overall. If I can think of ways to improve it even more, I'll submit more patches for review. =2D-=20 Chris --=-=-= Content-Type: text/x-patch; charset=utf-8 Content-Disposition: attachment; filename=0001-website-Clarify-the-descriptions-of-Guix-and-GuixSD.patch Content-Transfer-Encoding: quoted-printable From=20adf588a9daa73072ad3f1b39581ba5881a6cf780 Mon Sep 17 00:00:00 2001 From: Chris Marusich Date: Sat, 27 Jan 2018 16:31:02 -0800 Subject: [PATCH] website: Clarify the descriptions of Guix and GuixSD. * website/apps/base/templates/home.scm: Clarify descriptions. =2D-- website/apps/base/templates/home.scm | 47 +++++++++++++++++++++-----------= ---- 1 file changed, 27 insertions(+), 20 deletions(-) diff --git a/website/apps/base/templates/home.scm b/website/apps/base/templ= ates/home.scm index f7c2d1c..beb1b39 100644 =2D-- a/website/apps/base/templates/home.scm +++ b/website/apps/base/templates/home.scm @@ -36,10 +36,27 @@ (@ (class "featured-content")) (h2 (@ (class "a11y-offset")) "Summary") (ul + (li + (b "Dependable.") + ,(link-yellow + #:label "GNU Guix" + #:url (manual-url "Package-Management.html")) + " is a " + ,(link-yellow + #:label "purely functional" + #:url (manual-url "Introduction.html#index-functional-package-managemen= t")) + " package management tool. In addition to standard package + management features, it supports transactional upgrades + and roll-backs, unprivileged package management, per-user profiles, " + ,(link-yellow + #:label "and more" + #:url (manual-url "Features.html")) + ".") + (li (b "Liberating.") =2D " The Guix System Distribution (GuixSD) is an advanced =2D distribution of the " + " The GNU Guix System Distribution (GuixSD) is an advanced + distribution of the " ,(link-yellow #:label "GNU operating system" #:url (gnu-url "gnu/about-gnu.html")) @@ -47,34 +64,24 @@ ,(link-yellow #:label "GNU Project" #:url (gnu-url)) =2D "=E2=80=94which respects the " + ", with Guix at its core. Because GuixSD is " ,(link-yellow =2D #:label "freedom of computer users" + #:label "FSDG" #:url (gnu-url "distros/free-system-distribution-guidelines.html")) =2D ". ") =2D =2D (li =2D (b "Dependable.") =2D " It comes with the " =2D ,(link-yellow =2D #:label "GNU Guix package manager" =2D #:url (manual-url "Package-Management.html")) =2D ", which in addition to standard package management features, =2D supports transactional upgrades and roll-backs, unprivileged =2D package management, per-user profiles, " + "-compliant, all software in the distribution" ,(link-yellow =2D #:label "and more" =2D #:url (manual-url "Features.html")) =2D ".") + #:label "respects your freedom" + #:url (gnu-url "philosophy/free-sw.html")) + ". ") =20 (li (b "Hackable.") =2D " It provides " + " Both Guix and GuixSD provide " ,(link-yellow #:label "Guile Scheme" #:url (gnu-url "software/guile/")) " APIs, including high-level embedded domain-specific =2D languages (EDSLs) to " + languages (EDSLs) to declaratively " ,(link-yellow #:label "define packages" #:url (manual-url "Defining-Packages.html")) =2D-=20 2.15.1 --=-=-=-- --==-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEy/WXVcvn5+/vGD+x3UCaFdgiRp0FAlptGk4ACgkQ3UCaFdgi Rp2/jw//SlsWlghLm98oOIDycxOsUWEp9RUlrKVNtd6eWiuDGnhZKqiHjRa2rgWU ujN9LzLvt2XuMV3bphXzwkCdTADrRpd9GAw2cUrTH1+GXkFyr8jYeApxwdKBx47h CKw6p9eJD1vzg/OCkL7wYQLDBJV9vXSQBgLbnYFOO9Zog2M8BW6Nn7q0iDaXOuMl JSWqQB24MWU59EGs4MyA/RIWDFCEYJieNYBWTE2l/tL08tDs6hFBWUwdfCnVd2xM /uwRXbdyaZyEqttwJkrrM4X3A1UFlJPmCASR+pUh3TP57j7rBs3+63ixxba1mMSK IguicTWFFqjKXuBL6IAM77Ah5FRAvxc1YRCEciZFIarFXLbDs3O4mmlX84eyZsm9 +mzqlCGyF0VrznJLBobHRypCX56xeUpzZeICBdnSitVJ69q8ui+K28XjEhLY1IM+ BfEnj9nZXoZcxXa/8NpJ977TZ7s5mq5Iqci0LyQIl/AjhrkNfMYFpf93t+VnAnvp /11BLuVrzQMsHzNg3omtz0FHBu/KjcDhIjDW2hxcE/cCHgyWYdhVCHfMv4/z3DUf NP3JZ7QCvy4TL4zuRdxzxGeYiug/DZgy9kvp5fcICB2jUSAuoES6F7zHYytdq0MW LTOPG4V8oxBQ7fwY0yhPaIu+gqrCA1HsKMAGgOiRbx0WYw8BPDQ= =3HxX -----END PGP SIGNATURE----- --==-=-=--