l...@gnu.org (Ludovic Courtès) writes: > Hello, > > Chris Marusich <cmmarus...@gmail.com> skribis: > >> Ricardo Wurmus <rek...@elephly.net> writes: >> >>> Hi Guix, >>> >>> on the website it starts right away with a list of features: >>> “Liberating”, “Dependable”, and “Hackable”. 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’s what Liberating (free software), Dependable (transactional, > etc.), Hackable (it’s 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 “Introduction” and “Features” sections of the manual aim to achieve > that goal, but in a “constructive” way (stating what properties it has, > rather than what properties other solutions lack.) However, I think > it’s not that concise and it’s quite technical, so I’d 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. -- Chris
From adf588a9daa73072ad3f1b39581ba5881a6cf780 Mon Sep 17 00:00:00 2001
From: Chris Marusich <cmmarus...@gmail.com>
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.
---
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/templates/home.scm
index f7c2d1c..beb1b39 100644
--- 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-management"))
+ " 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.")
- " The Guix System Distribution (GuixSD) is an advanced
- 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))
- "—which respects the "
+ ", with Guix at its core. Because GuixSD is "
,(link-yellow
- #:label "freedom of computer users"
+ #:label "FSDG"
#:url (gnu-url "distros/free-system-distribution-guidelines.html"))
- ". ")
-
- (li
- (b "Dependable.")
- " It comes with the "
- ,(link-yellow
- #:label "GNU Guix package manager"
- #:url (manual-url "Package-Management.html"))
- ", which in addition to standard package management features,
- supports transactional upgrades and roll-backs, unprivileged
- package management, per-user profiles, "
+ "-compliant, all software in the distribution"
,(link-yellow
- #:label "and more"
- #:url (manual-url "Features.html"))
- ".")
+ #:label "respects your freedom"
+ #:url (gnu-url "philosophy/free-sw.html"))
+ ". ")
(li
(b "Hackable.")
- " It provides "
+ " Both Guix and GuixSD provide "
,(link-yellow
#:label "Guile Scheme"
#:url (gnu-url "software/guile/"))
" APIs, including high-level embedded domain-specific
- languages (EDSLs) to "
+ languages (EDSLs) to declaratively "
,(link-yellow
#:label "define packages"
#:url (manual-url "Defining-Packages.html"))
--
2.15.1
signature.asc
Description: PGP signature
