![]() ![]() If you were to search for my rants about this, you’d see that 5 years ago I agreed with you. Based on what I’ve seen here? The user base is committed and geeky enough to do a fantastic job with it-just like Adobe’s users do. All he’d have to do is periodically review for obvious errors. Let him add to the wiki as he adds features and then let the community flesh things out. My suggestion? They should develop a Wiki like Adobe has done and drop ‘docs’ altogether. PLUS, there’s the multi-lingual and x-platform issue which makes it even more difficult. But there are -few- devs who write this quality of program who are also great doc writers. And if you think you do? You’re a moron, because what we do is just too cool for school.’ STEINBERG WAVELAB PRO 9 DOCUMENTATION SOFTWAREIt goes like this: ‘Our software is so darned easy to use, you don’t -need- a manual. I’m in my 50’s now and I thought that schools were trying to evolve kids upward towards better docs, but I see that it’s just morphed into a new form of arrogance, which I call the ‘Apple Phenomenon’. That’s just how -every- programmer was raised for generations: Spend 95% of your time on code and 5% on docs… and only then if you’re gonna get fired! There’s a scene in ‘The Social Network’ where the ‘contestants’ for a job slug it out in a Thunderdome of shots to see who’s the most ‘manly’ dev. Speaking as an ex-dev, I understand this well. ![]() It is to software development what ‘communication’ is for soldiers… essential, but not part of the standard training. Documentation has always been the dirty little secret of software. ![]()
0 Comments
Leave a Reply. |
AuthorWrite something about yourself. No need to be fancy, just an overview. ArchivesCategories |