If you read a reference topic or how to and don’t find what you are looking for, say so! At the bottom of every page is a little section that asks for feedback. It usually starts just with “Did you find this helpful?” When you click either yes or no, it then opens a field for you to give us your thoughts.
To coin a tired cliché, “help us help you.” Sounds corny, but it’s really true. As a writer on the IE developer doc team, I consult the oracle of ratings and site comments for my feature areas. All the writers on our team and other teams also do the same.
We use that information to help guide us to fix topics with broken code, wrong information, missing content, and a whole bunch of other issues. MSDN dropped the community content a while back (IMHO, wish they hadn’t), so this is the only way we can hear from our readers.
All of our topics are rated on a scale of 0-100%, based on the yes/no answers. Out of 100 people, if 25 don’t like a topic and 75 do, our score is 75%. It’s a straight average. Ratings are good, though not really helpful when it comes to improving content.
However, the number of ratings is only 24… or two a month. Yikes! I’m not a statistician, but I’d think that that is a pretty small sample set. Of that 24, only 14 people wrote a comment.
I really appreciate all the good comments (11 of them) that ran from simple (Really helpful) to a bit more detailed (Super detailed documentation with very precise and helpful examples and explanations. Very well documented, super!). That second comment was in German, and translated through the Bing translator.
On the more critical comments, those ranged from “this in not persect” [sic] to “HTML 5 video as a mouseover animation element strten.” Since this was another Bing translated comment, I’m not sure what strten is, but I think the person wanted to be able to mouse over a video, and have it start playing. That’s cool, and you see it all the time in search engines. definitely helpful, and that’s something I’m going to do.
The third, and not that helpful feedback was “me aburri en la primero parte, nose deberian usar algo mas simple, cambie de programadores, algo mas facil para lo que se busca”, which Bing translated to “I got bored in the first part, nose should wear something more simple, change of programmers, something more easy for what you are looking for.” I suspected a bad translation, but when I dropped it into translate.google.com, I got the same thing. Not very helpful.
But, I noticed that Google added a note at the bottom, saying “Did you mean: me aburrí en la primero parte, no se deben usar algo más simple, cambie de programadores, algo más fácil para lo que se busca.” When I clicked on that one, it came up “I got bored in the first part, you should not use something simpler, change of programmers, something easier to what is sought.” It started to make a little sense, though I was wondering if they meant don’t use something simple, or TO use something simpler.
In these examples, there were three issues that blocked me from really getting what the problem was.
So how do you give good feedback? There is a lot of content, and sometimes you end up in topics that don’t have anything to do with what you’re looking for. I saw this in another topic where someone said “this is too technical.” Sorry, this is for developers, it’s going to get technical. I suspect it was a consumer who found their way into developer content by way of search (don’t get me started on search …) Here’s a few points on giving better feedback.
So enough of me talking about the good, bad, and the ugly comments. Send us your comments. Take a minute if an article doesn’t hit the mark to tell us why. We do look at most comments, and use that information to improve the content. So, “Help us, help you” by rating topics, and by leaving some details when you’re not happy about them. Of course, we’ll ALWAYS accept praise.
Until next time,