Conversation

Jonathan Corbet

So I am not quite sure what to make of this article. It is nice to see attention paid to documentation... but this is really about the man pages, and somehow the problem is Linus's fault...? The idea that we can solve it with some sort of editorial structure in the "post-Torvalds era" seems ... weird.

https://www.heise.de/en/news/Linux-No-money-for-documentation-9978257.html
2
6
15

@corbet I think they are simply putting together two (admittedly disjoint) ideas: Torvalds might be succeeded by a team + LF has paid for projects before => LF should pay for a team for documentation editors. (And now, not necessarily when Linus retires.)

The fact that the man pages project is somewhat confusingly referred to as "Linux documentation" is a separate issue... one that I don't blame them for.

0
0
1

@corbet Heise is renowned for good tech journalism due to c't which has long history. iX OTOH (where this piece appeared) is a side gig of them where they produce sloppily written articles aimed at "IT decision makers" with practically no journalistic value...

1
0
0

@jmm sorry, as someone that worked for heise online and c't (but not for iX) for 20+ years I have to say that's a way too simple description.

All three publications have slightly different approaches and target different consumers, which is why they work somewhat differently. But in the end you find a lot of good and bad stuff in all of them.

In the end I'd say it's 90+ percent the author that makes the difference (and the editor up to some point), not the publication.

(CC: @corbet)

0
0
1