unofficial mirror of guix-devel@gnu.org 
 help / color / mirror / code / Atom feed
* [doc RFC] Tame the Guix profile blizzard?
@ 2018-07-09 23:40 George Clemmer
  2018-07-10  8:54 ` Nils Gillmann
  2018-07-10 22:13 ` Ludovic Courtès
  0 siblings, 2 replies; 6+ messages in thread
From: George Clemmer @ 2018-07-09 23:40 UTC (permalink / raw)
  To: guix-devel

ISTM our doc is a veritable "Profile Blizzard."


The term occurs 173 times in guix.texi


The "user profile" is referred to in multiple ways:

 (guix) Application Setup: "your Guix profile"

 (guix) Features: 'own “profile”', "per-user profiles", "their profile"

 (guix) Invoking guix package: "user’s own profile", "user’s default
 profile", ‘$HOME/.guix-profile’

 (guix) Invoking guix environment: "package profile"


The "system profile" is referred to in multiple ways:

 (guix) Using the Configuration System: "Globally-installed packages"

 (guix) operating-system Reference: "global profile",
 ‘/run/current-system/profile’

 (guix) Networking Services: "system profile"


An unnamed type of "environment profile" is produced by 'guix
environment'

 (guix) Invoking guix environment" ‘GUIX_ENVIRONMENT’ variable


An unnamed type of "custom profile" is produced by the 'guix package' -p
option.


(guix) Top mentions only an entirely different use of the term:

 * Invoking guix size::          Profiling disk usage.


(guix) Concept Index contains only (guix) Invoking guix package
references.


ISTM we can improve this situation as follows:

1) agree on a canonical term to use for the 4 types of profiles

2) update the doc accordingly

3) add a top level discussion of profiles

WDYT? - George

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2018-07-11  8:05 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2018-07-09 23:40 [doc RFC] Tame the Guix profile blizzard? George Clemmer
2018-07-10  8:54 ` Nils Gillmann
2018-07-11  3:21   ` George Clemmer
2018-07-11  8:06     ` Nils Gillmann
2018-07-10 22:13 ` Ludovic Courtès
2018-07-11  2:52   ` George Clemmer

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/guix.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).