In the words of someone on #gnome-hackers, ‘Documentation isn’t sexy’. Well, dang. I joined the wrong project. #gnome-sex, anyone?
Documentation is never going to garner great accolades either. Nobody’s going to say ‘Hey, this piece of software has the best manual ever!’ It really only gets a mention if it’s pretty bad.
So it was nice to see the review of 2.14 on Linux.com mention the documentation, even if it was only as ‘the stuff that’s in Yelp’. Though they managed to spot our number one problem — ‘At times, the text in Yelp refers to older releases.’ — and they say we need polish. They’re not wrong.
I was pretty confident the docs team had tracked down and stamped out nearly every mention in the User Guide of features not seen since GNOME 2.6 (yeah, it was that bad), but there are the application manuals to consider too.
So still a lot of work to do on the documentation, and as I said, there’s a few rough patches in the User Guide. Those I intend to fix for 2.14.1.