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: Sun, 21 Jan 2018 23:04:20 -0800 Message-ID: <87efmixtl7.fsf@gmail.com> References: <87inc0gzoz.fsf@elephly.net> 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]:33788) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1edW9f-0001SR-88 for guix-devel@gnu.org; Mon, 22 Jan 2018 02:04:32 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1edW9c-0007By-Q0 for guix-devel@gnu.org; Mon, 22 Jan 2018 02:04:29 -0500 Received: from mail-it0-x232.google.com ([2607:f8b0:4001:c0b::232]:40443) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1edW9c-0007BZ-LA for guix-devel@gnu.org; Mon, 22 Jan 2018 02:04:28 -0500 Received: by mail-it0-x232.google.com with SMTP id 196so8622631iti.5 for ; Sun, 21 Jan 2018 23:04:28 -0800 (PST) In-Reply-To: <87inc0gzoz.fsf@elephly.net> (Ricardo Wurmus's message of "Wed, 17 Jan 2018 18:30:52 +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: Ricardo Wurmus Cc: guix-devel@gnu.org --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable 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=9C= Hackable=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? I think that's the most important thing to explain. I've also found that it's one of the most difficult things to explain. I think we should entice readers by concisely explaining that, if we can. 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? Footnotes:=20 [1] https://nixos.org/~eelco/pubs/phd-thesis.pdf =2D-=20 Chris --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEEy/WXVcvn5+/vGD+x3UCaFdgiRp0FAlpljPUACgkQ3UCaFdgi Rp3jURAArPFHEccyoRlF1+6JhMzkBUuBVQs1UyfAlJU2ocFs5beFuSqYtJ2BhWhV cAZtnSPzIZXFp2BJAltQvTCXNt5y5l5ULdCXYCoE04VTyD4QSieGgQldRb+cy1qd TGdSb8CZLgK3uUhOhEobuDTc2q43h2MJ8aR7uE0YuaLqgJnlt7oYf1rwg139DP5H OGnXPj7nEywIvHXkqueM59IA+ec2ZQ2Kd6NmUxCXqfqTuWV5HeE9uC7D8dsq0GfV XbQDPxbEb5yhQAVUtsOil9MD/4icXFBShkVbvxnkLB3fKS5UvJLHylMNji1ZNwkZ 0XSn+lmyXdWuPltfqW6yBGiaYBdANZLk6rzk0wyf8a9de2+pwHkhMxezLqhMxXQ2 J5XFjGFlgyH7h2joFzWHvm34KyWMW5fGpMACvIHJbCT7a67ououWFcZgaCKDQzT9 zpv+OC3AKOQhGPC3mY+PsbrjeRgh0tqN5R0A04cVN2kpsC1gHsj36kGAGu77MqMi G+wBGMyfS/6ZR/q5tuLkphS/mz1p33qNxu1oVUanwQn0DdkYBiAt/MKrb1buA27h YWc1QtCaRHOdgMXp5f3OwOK5MdgLJTH7kC4ei/vARJFq6BkqdvY7hP6QWdibEhBx vLiqN2GuoJ8KHOT+y0IsTdsciKZOg9iVIxT1OCfcJWq+farUaEE= =qz6M -----END PGP SIGNATURE----- --=-=-=--