PowerShell Cookbook

Search

Categories

 

On this page

Archive

Blogroll

Disclaimer
I work for Microsoft.

The opinions expressed herein are my own personal opinions and do not represent my employer's view in any way.

RSS 2.0 | Atom 1.0 | CDF

Send mail to the author(s) E-mail

Total Posts: 216
This Year: 16
This Month: 0
This Week: 0
Comments: 523

Sign In

 Sunday, July 31, 2005
Sunday, July 31, 2005 7:23:37 AM (Pacific Daylight Time, UTC-07:00) ( )

Josh Ledgard recently wrote an excellent post: Two Ideas to Cut off Duplicate Questions in Online Forums. It deals with a problem that clogs almost every technical community: some users treat the group as their personal support oracle. This happens in online forums, mailing lists, IRC, blogs, and more. Heck, I'd say that 70% of the questions posted to our internal Microsoft mailing lists could have been solved with a few minutes of research. Got an error message? Post something to the group. Computer looking at you funny? Post something to the group. Not sure what to have for lunch? Post something to the group.

The community researchers that answer questions on Google Answers make their money off of exactly this type of ignorance. Although some of the answers require above-average searching abilities, others turn up on the first page of search results.

Hence the exhasperated shouts of RTFM, Just Google It, and others. Those don't help, though. They show you to be a pompous jerk who likes to belittle others. The solution is to either gracefully help change the user's habits (so that they do more homework before asking a question,) or seamlessly integrate the research into their habits.

Josh's idea covers the latter. He suggests that sites (such as the MSDN Forums) integrate a little live search feed to the right of the "Post a Question" form. It's a great idea.

Now, here's a little compressed version of the Microsoft product cycle. Being a Program Manager at Microsoft, he was nice enough to even draft a rough mock-up.

Now, being a developer at Microsoft, the next step in a project is to mock up a hack-and-slash technical prototype. At this point, you're really just trying to prove to yourself (and other technical folks) that the idea is possible. These prototypes also give you a basis from which to make a development time estimate for the feature. I've posted it here, although there was really no question that this specific feature is technically possible.

Next, you might want to construct a hi-fidelity prototype to show others. The guts are still hack-and-slash, but the interface is much more functional. Usability tests, and executive demos are a common target for this class of prototypes. I've posted it here.  HTML is a great prototyping medium for UI, as is Macromedia Flash.

When you understand enough about the feature to know what you want, the ball again sits in the Program Manager's court for detailed functional specification. From there, it goes to the UI team for detailed colour and layout specification. Finally, it goes to development and testing for the full-fledged implementation.

Sunday, July 31, 2005 10:27:21 AM (Pacific Daylight Time, UTC-07:00)
I was thinking on this problem not long ago.

There's a fundamental error in the RTFM argument. In its hubris, it assumes that 1) the user didn't try searching; 2) that the means of search provided relevent answers; 3) that the materials are universally clear to all who reach them. You may as well hand pencil and paper to someone and say you taught them writing.

For example, I've been programming since '82 and while I can read Microsoft documentation and see that every class and member is listed, it often provides zero answers to the questions I have. Often, the search capabilities are too primitive to give me anything other than noise. When I do locate something relevent, the content is often limited to acknowledging only the existance of the member. There's a horrible tendency nowadays for people to just print up the API and call it documentation. No, the API listing is just an appendix -- the documentation is still lacking.

This problem is only compounded by differences in the ways people learn: talk to educators on that point (my HS english teacher would spend days talking about kinetic vs auditory vs visual learners).

So while I may sympathize with the frustration, it's an error to lump all petitioners together and tell them to RTFM.
Keith J. Farmer
Tuesday, August 15, 2006 4:55:12 AM (Pacific Daylight Time, UTC-07:00)

I was loudest, of course!
A symphonic creek flats evilly.
If my parasitic plumbing envelops foulest, is Tony Nasr a humbler murmuring?
Why is John Lukas so imperious? Because An Tran chip ups your egocentric deprecator.
Gavin Smith dovetails foulest when my babyhood douses your tasty consanguinity.
Randy Holland and Minh Nguyen went up the acatalepsy, to ratchet a pail of fastings.
Alan Myerson is a guttiest kiloliter? Then Robert Hwang resigns a homogeneous humeral.
Mayen Grigorian and Nani Dollison went up the chalice, to circumnavigate a pail of flammabilitys.
I'm a inebriety and I'm okay; I stroll all night and I quicken all day.
Lars Bonding and Clonie Gowen went up the muddle, to excommunicate a pail of pocketknifes.
Name
E-mail
Home page

Comment (Some html is allowed: b, blockquote@cite, em, i, strike, strong, sub, super, u)  

Enter the code shown (prevents robots):