02/02: doc: Add "Readability" section to Guix Days 2020 "Parameterized packages".

[Pierre Neidhardt]

ambrevar pushed a commit to branch master
in repository maintenance.

commit c374a8fd9aec1ae0d2699d0793a44b40c7846c94
Author: Pierre Neidhardt <address@hidden>
AuthorDate: Mon Feb 17 11:26:24 2020 +0100

    doc: Add "Readability" section to Guix Days 2020 "Parameterized packages".
    
    * doc/guix-days-2020/parameterized-packages-guix-days: Do it.
---
 doc/guix-days-2020/parameterized-packages-guix-days.org | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/guix-days-2020/parameterized-packages-guix-days.org 
b/doc/guix-days-2020/parameterized-packages-guix-days.org
index e1aead5..4a30ca4 100644
--- a/doc/guix-days-2020/parameterized-packages-guix-days.org
+++ b/doc/guix-days-2020/parameterized-packages-guix-days.org
@@ -35,6 +35,10 @@ increased complexity. As the number of parameters grows, 
there is a
 explosion in the number of possible parameter combinations. This means
 that Guix may be unable to test all possibile parameter combinations
 available to the end user.
+*** Readability
+To apply a parameter to a package definition, we need a bunch of ~(if
+flag-is-set ...)~.  This can make the package definitions significantly more
+cumboersome to read.  Helper macros or functions could help to some extent.
 *** Substitutes
 When a user customizes their package parameters, they are creating a
 distinct version of the package that will have a unique store