Re: website: say what Guix is at the very top

[ludo@gnu.org (Ludovic Courtès)]

Hi Chris,

Chris Marusich <cmmarusich@gmail.com> skribis:

> From adf588a9daa73072ad3f1b39581ba5881a6cf780 Mon Sep 17 00:00:00 2001
> From: Chris Marusich <cmmarusich@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.

I’m not convinced by the changes, but that’s also because I think we’re
really fine-tuning very little text, so at some point it gets harder to
move forward.  :-)

> +	(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"))
> +	".")

It was on purpose that I did not insist on “purely functional.”  That’s
obviously the core concept, but I think it’s obscure to many (especially
in this context), whereas “transactional” may make sense for a wider
audience.

>  	(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"))

I’m not sure the extra words are necessary.

Note: I’m probably biased so I’m happy if others can weigh in on these
things!

Ludo’.