Re: Divvying up service definitions

[Attila Lendvai]

> I dont think there's any problem wrt categorization. For your Kerberos
> example, either would be fine as they're not mutually exclusive.
> (though I'd lean towards 'authentication' here)

sure, but the crux of the issue here is how to improve code readability; i.e. 
would it make the humans working on the Guix codebase more effective.

if all the 3 options are equally reasonable, then some people will have to 
check two places before they find it in the third.

with such a codebase people will develop a habit of just using multi-file grep 
to find stuff... which is arguably a better strategy to begin with.

and it's worth pointing it out here that following grep'able patterns like 
`define.*kerberos` highly facilitates code navigation, and especially so for 
newcomers. this is one of the features of lisp(ers) that i badly miss in many 
other languages/cultures. and arguably, this is much more important than the 
placement of the definitions.

and while i'm ranting, another useful strategy is to give unique names to 
abstractions, and make sure that wherever these abstractions are employed, that 
name shows up in the source code; i.e. it can be grap'ped. IOW, names should 
not be e.g. programmatically assembled in DWIM'ish ways, unless it is a 
frequent enough pattern that the loss of grep'pability is worth it. or 
abstractions should not be hidden behind late binding, unless it's worth the 
additional loss of code readability.

ultimately, definitions shouldn't live in text files, but in a source code 
database, with proper search and projection tools in the editor (and the DVCS) 
that understand the graph nature of the source code. that would make this 
entire discussion moot, but we're not there yet.

-- 
• attila lendvai
• PGP: 963F 5D5F 45C7 DFCD 0A39
--
“The meeting of two personalities is like the contact of two chemical 
substances: if there is any reaction, both are transformed.”
        — Carl Jung (1875–1961)