Just a quick response to “Top Open Source technical writers on the Web”.
First, I’m sure the intention was well-meant. Thanks for trying to uplift open source technical writers.
Second, I put in a comment response on the blog entry, which was more self-serving than helpful:
Not sure what the metrics used are … but it is worth mentioning the group of writers at the Fedora Project. In terms of sheer number of pages and breadth of content, this is the upstream for all Red Hat product manuals:
Probably more than a thousand pages of CC BY SA 3.0 Unported licensed content.
http://fedoraproject.org/wiki/Docs_Project
Third, I really want to say — all this rockstar stuff is plain wrong.
It doesn’t inspire people and get them fired-up to get on the next top-ten list.
It drags down morale.
It is even a harder hit wherever there is a cross of passion and volunteer time.
Ask an artist if they love seeing a list of top artists in their region or media? Unless they are on that list, I’m sure the answer is unpublishable in this family friendly magazine.
Call out group efforts and thank all those involved in no particular order and without leaving anyone off the list? OK, that works.
But tweets to your homeboys when they do something you love in your community just makes all the people even peripherally involved in that effort feel left out. Forgotten. As if they don’t belong.
I’ve been wanting to say this for a long time. I think it’s a basic idea that many Fedorans agree with. But I didn’t want to be mean to fellow community leaders with good intentions who don’t realize their basic idea is off mark.
So, DMN Communications poster, please don’t feel singled out. I am motivated to write this because I feel personally saddened that all the hard working writers who work through the Fedora Project are going to feel a bit marginalized from that top-ten list. Ironically, isn’t the marginalization of open source writers in general the very reason you wrote the list in the first place?
Let’s not replicate the top-ten lists of late night TV and technical publishing. We aren’t in competition with each other for popularity, OK?
(Updated to say “thank all those involved in no particular order”, with the “no” added; it was intended to be there, blame my editor.)
There was recently a series of postings on top ten red hatters. I was on neither list. I certainly felt like I must have done something wrong.
Well said!
Well, it seems to work for Ubuntu, if you read Jono Bacon blog, you can see he often use this metaphor. On the other hand, I also dislike this, most of the time, this sound wrong. But I tought I was being simply weird and asocial 🙂
Regarding the superrockstar method working for other people, I think that remains unproven. It is a way to quickly build a community that is reminiscent of a sports team fan base. Do you get a long-term, sustainable community of contributors out of that?
I see that many projects do have well known personalities, and some are flown around to every event. But they are such a small percentage of such a large community that gets so much done, I wonder how much the benefits of that model outweigh the much larger number who get forgotten and feel marginalized?
My argument completely ignores when people feel uncomfortable being singled out. I know I do. Everyone feels differently about being singled out for praise, especially if they are a good team player.
Regarding top-ten lists in general, there are times when they are very useful. They can even spur good competition. Top-ten bug reporters or closers; top-ten wiki editors; top-ten posters to a mailing list. (Although I’ve had being in the latter category a reason for slowing way back *cough* memo-list *cough*.)
So perhaps there is a metric that can be used to count “top” technical writers, but it should be objective and quantifiable. Number of books edited; number of page written; quantity or quality of commits; etc. But that is a pretty big research project with dubious value outside of a doctoral thesis. (Well, I’d like to know, along with tool choices, and lots of other stuff, for any large set of communities, but I cannot code that and don’t (yet) have the influence to Make It So.)
Compared to the people or groups singled out, I just see 1000x the hard work coming from people who usually get thanked in aggregate as part of a team really getting stuff done. I’d rather we spend our time finding out how to make those people feel appreciated. I am unable to hug or send chocolate to all of them, so what to do?
The top ten Red Hatters? That list must clearly be clearly about who can make the best puns. In which case I think Grant, Alex, and Daryl win.
More seriously, I agree, the rock star term is really really unfair to the Jazz Fusion and Techno coders of the world. Everybody should get to have their own band if they want one. Support local music!
And I’m not sure it’s working for Jono Bacon, either:
https://twitter.com/jonobacon/status/5597881627
https://twitter.com/jonobacon/status/5606825772
Or even this:
http://magazine.redhat.com/2007/05/31/announcing-the-fedora-award-winners-for-2007/
… and the outfall from that, which sucked for a long time. Even the best ideas can fail miserably when the underlying meme is incorrect.
In reply to comment 5:
I think if we were going to start a metric wishlist.. I’d go a little further. Instead of a top ten list based on quantifiable output.. I’d really like to know the top ten people in terms of efficiency of quality of output. Because its those people the rest of the contributors in an area can really learn from to be better contributors.
Holding someone up for recognition who is extremely passionate and spends an immense amount of time working on a subject area may not be the best role model to stand up…because the vast majority of people aren’t going to be able to be that kind of contributor. In fact the existence of such people may be indicative of a process problem which makes it difficult to distribute work among many people.
I would personally much rather find the people who make best use of their volunteer time, and then have then explain to others how they organize their time and workflow so we can all learn from them on how to be better contributors. I want to learn how to do what they do even if I only have a few hours a week to contribute and my overall output is small compared to someone who can put in 40 hours a week on contributions.
I don’t want heros to look up to… I want teachers to learn from.
-jef
[…] of any open source technical writers. Karsten Wade—someone I respect very much—followed up with Calling out superrockstars considered harmful, in which he argues that top-ten lists drag down […]
[…] of any open source technical writers. Karsten Wade—someone I respect very much—followed up with Calling out superrockstars considered harmful, in which he argues that top-ten lists drag down […]