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

[Ludovic Courtès]

Hi Chris,

Chris Marusich <address@hidden> skribis:

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