More Examples!

Recently my documentation group received a presentation of Voice Of the Customer data. The most resounding request by far is for more examples. Interestingly, we also received high marks for the examples in our documentation, so I guess we do a good job of providing examples but users always want more.

I would love to provide you with more examples. It would be my greatest joy next to hiking Mission Peak at night with Dog. I work with Solaris developer docs (Writing Device Drivers, Device Driver Tutorial) but I am not a kernel programmer myself. I cannot just pull examples out of my hat. Engineering is busy. To get engineering assistance, I need to make specific requests.

To help me help you, please tell me what kinds of examples you would like to see. If you are a Solaris developer, perhaps you can even provide an example. Don't be shy.

OpenSolaris is a humongous example in a way, but locating exactly what you need to know by combing through the code can be challenging. Save yourself the blisters. Tell me exactly what you want, and I will do my best (which is not too bad) to get that information and publish it.

One of our OpenSolaris developers recently requested particular kstats examples, and now one of our engineers (thank you, Alan) is working with me to provide that.

If I get some responses, I will provide a wiki site for anyone to add to the Solaris developer examples wish list.

Posted at 11:55PM Jun 13, 2006 by alta in Documentation  |  Comments[1]