On 16/09/2022 12:37,
Mut...@dastardlyhq.com wrote:
> On Fri, 16 Sep 2022 06:02:12 -0000 (UTC)
> Juha Nieminen <nos...@thanks.invalid> wrote:
>> Michael S <
already...@yahoo.com> wrote:
>>>> Just read the cringe language used in the *official* Linux kernel coding
>>>> style guideline page:
>>>>
https://www.kernel.org/doc/html/v4.10/process/coding-style.html
>>>>
>>>
>>> I like the language of this text.
>>> Style itself - less so; agree or accept with 80%, but not with another 20%.
>>> It seems, what you consider "professional language" I'd consider boring
>>> and bureaucratic. Or, may be, not. In order to know for sure you have to
>>> give me an example of what you consider well-written style guide.
>>
>> An official documentation intended for use by companies and individual
>> people from all around the world, both hobbyists and professionals,
>>from a wide variety of fields of industry, from a wide variety of
>> backgrounds, countries, cultures and customs, *should* be as professional
>> and neutral as possible. It *should* be "boring and bureaucratic".
>
> Bollocks. A lot of the people writing linux code are hobbiests and if you
> want to attract those sorts of people a light hearted approach is a good
> approach. The LAST thing you want is dull, tedious documentation that drones
> on to the point where people just stop reading it.
>
It is possible to be light-hearted while remaining professional.
It is /decades/ since the core of Linux development was done by hobby
programmers. The great majority of the work on the kernel, excluding
support for more obscure hardware, is done by people who are paid to
write the code.
It is important for the project that "small" programmers don't feel
alienated, or that it is too bureaucratic, but it is also important to
remember it is a professional project, run by professionals, and used by
professionals.
Fortunately, the style guide here is something only the actual technical
coders will look at - and even then, most contributors will copy the
existing code style rather than looking at the guide. They are much
more likely to laugh at it than "corporate leader" types who might
wonder if this is the kind of project they can bet their company's
future on.
It's worth noting that Linus Torvalds has gradually developed a more
mature, diplomatic and professional style of leadership and of
communication with the outside world, while still maintaining a unique
development environment. I would expect that sooner or later, this
guide will also get cleaned up (as well as being modernised to include
C11, now that it is the standard for the kernel).
>> When you write things like
>>
>> "I'd suggest printing out a copy of the GNU coding standards, and NOT
>> read it. Burn them, it's a great symbolic gesture"
>>
>> or
>>
>> "Encoding the type of a function into the name (so-called Hungarian
>> notation) is brain damaged [...] No wonder MicroSoft makes buggy programs"
>>
>> the only thing you are doing is alienating people. (And those are just
>
> You might be alienating some aspies with zero social skills but for most
> people it'll elicit a chuckle and keep them reading.
>
>> two examples of many.) Also, how many big respectable international
>> corporations would put this kind of language in their official
>> documentation for the wider public?
>
> You're confusing business products with an open source project. One you pay
> for, one you don't.
>
Much of the Linux world is professional and paid-for. When you buy a
server from IBM with Red Hat Linux, you pay a /lot/. Linux is not
driven by zero-cost usage of software written by people for free. Open
source is not primarily about zero cost (though the fact that you can
use it for zero cost hugely increases its popularity) - it is about an
open development model, and sharing the cost and sharing the results.
>> The Linux kernel is not a small hobby project for some small group of
>> nerds anymore. It hasn't been for like a couple decades now. And it
>> isn't even intended to be. The very coding style document itself
>
> Except plenty of people who work on the kernel ARE hobbyists.
>
They outnumber the professionals in terms of numbers of contributors -
but the professionals outnumber the hobbyists in terms of the work done
and code committed. And if you look at in terms of the key parts of the
kernel, used by everyone, the difference is vastly greater.
The style of this coding guide was fine when it was written, but the
Linux project has moved on and changed enormously since then. I doubt
if it has caused much real negative reaction in practice, but it is
certainly due for an update.