Myself along with a coupla others gave the poor quality of the ColdFusion docs a bit of a battering on Twitter last night:
Now that the @coldfusion documentation is a wiki, we can go in and add egg to @Adobe's face where appropriate: https://t.co/ARQzcQ8g0M
— Adam Tuttle (@AdamTuttle) December 19, 2013
.@fermatjen, can you pls kick someone in Bangalore up the arse and get them to finish their docs? https://t.co/uuhkI3taYz cc @ColdFusion
— Adam Cameron (@dacCfml) December 19, 2013
@dacCfml Don't you love it how they say it's a wiki but the public cannot edit it? Seen so many inconsistent examples I've wanted to fix.And it continues...
— Indy (@Indy_Griffiths) December 19, 2013
@Indy_Griffiths one good thing is one of the voting options on the page is "pathetic". I urge y'all to vote ;-) #ColdFusion
— Adam Cameron (@dacCfml) December 19, 2013
@Indy_Griffiths yeah,they have fucked that up too. But Frank (@fermatjen) is bloody helpful. Talk to him re getting the right perms to edit
— Adam Cameron (@dacCfml) December 19, 2013
But, as has always been the case, Frank gets back to us and gets follows it all up straight away:
@dacCfml @Indy_Griffiths Guys, mail us at cfdocs@adobe.com to become ta Wiki contributor. The process would just take a few hours.
— Frank Jennings (@fermatjen) December 20, 2013
@dacCfml @coldfusion I have initiated the process. We will fix this page in a few days. I will post a comment once it is ready.
— Frank Jennings (@fermatjen) December 20, 2013
@fermatjen thank you for being so responsive (in the face of such adversity) @dacCfml @coldfusion
— Sean Corfield (@seancorfield) December 20, 2013
@seancorfield @dacCfml When we r screwing up and u don't say anything to us anymore that means you've given up on us. Keep em comin! Thanks
— Frank Jennings (@fermatjen) December 20, 2013
Sean's right - thanks Frank, yer a dude. And it's really good to see Frank shouldering responsibility here ("when we r screwing up...") despite the fact he just runs the site, he didn't write any of the docs, and all this cruft existed already before he had it dumped on him.
Obviously the ColdFusion documentation are a critical piece of the whole ColdFusion package, so it's really encouraging seeing someone take it seriously. Now if only the ColdFusion team themselves could, too. Still: if we badger and harry, we'll get there.
Also Frank raises a very good point which is worth being reminded about: we can all pitch in making the ColdFusion docs a better place... sign up to become a moderator so that if you see something wrong / missing / subpar in the docs... you can fix it! I've patched a few things in there already, and will continue to do so as I see stuff needing attention (more on that soon...).
So... Frank... mate, you're a bloody legend. Keep up the good work.
--
Adam
