First line should describe the file, not Guix

First line should describe the file, not Guix

[McSinyx via Development of GNU Guix and the GNU System distribution.]

Hello Guix,

All Scheme source file in Guix starts with

> ;;; GNU Guix --- Functional package management for GNU

which is definitely the first thing one looks for right
after openning one.  For example, when I look into aa.scm,
I need to know whether it is for _ambiguous abbreviations_
or _any another_ stuff.

I suggest changing the first line into describing the source file,
which goes in hand with

> This file is part of GNU Guix.

Is there any reason against this that I'm not aware of?

Best regards,
McSinyx

First line should describe the file, not Guix

[McSinyx via Development of GNU Guix and the GNU System distribution.]

Hello Guix,

All Scheme source file in Guix starts with

> ;;; GNU Guix --- Functional package management for GNU

which is definitely the first thing one looks for right
after openning one.  For example, when I look into aa.scm,
I need to know whether it is for _ambiguous abbreviations_
or _any another_ stuff.

I suggest changing the first line into describing the source file,
which goes in hand with

> This file is part of GNU Guix.

Is there any reason against this that I'm not aware of?

Best regards,
McSinyx

Re: First line should describe the file, not Guix

[Ludovic Courtès]

Hi,

"McSinyx" via "Development of GNU Guix and the GNU System distribution."
<guix-devel@gnu.org> skribis:

> I suggest changing the first line into describing the source file,
> which goes in hand with

I agree in principle (this is what many GNU packages would traditionally
do), but there are many files in Guix these days…  Maybe a good exercise
for someone who’s taken a guided tour of the code such as
<https://10years.guix.gnu.org/video/guixy-guile-the-derivation-factory-a-tour-of-the-guix-source-tree/>?

Thanks,
Ludo’.