SRS 5 Wiki Documentation: Everything is O.K.
By pkasper on Aug 03, 2009
The good news is that my prediction that everything was going to be o.k. held true. After going through a vigorous Early Access program (which ended on July 31st), the wiki documentation held its own. In fact, we actually received the following positive feedback from customers:
- "I like the new wiki format for documentation."
- "wikis.sun.com online documentation is huge improvement"
- "I relied heavily on the wiki.. certain steps are always tricky during an upgrade and the wiki documents these better."
- "Again the wiki is cool, but it is hard to find information sometime and customers want pdfs."
The last feedback brings up a good point about some users still wanting (or needing) PDFs, and I forgot to mention in my last post that we have that covered as well. On both the SRSS and SRWC documentation sites, you can dynamically build PDFs based on all the information on the wiki. And, the PDFs will be in sync with the latest content on the wiki. Here are the specific pages where you can get to the PDFs, and the links to these pages are also provided on the left-hand nav bar on each site:
I know these PDFs are not as slick as what you are used to from Sun, but we are working on that and the output will continue to improve. I'm on it.
Comments, Calling All Comments
Now, even with the positive feedback, there is still room for improvement...there is always room for improvement. We are getting ready for the next Early Access program and we are continuing to improve the content based on reviews and comments. If you are feeling some post-EA1 blues and want to provide more input to the SRS 5 release, you are in luck. The wikis are always open for comments and you can make comments on a specific page.
- Log in to wikis.sun.com.
- Navigate to the page.
- Choose Comment from the Add icon.
The comment section is displayed.
- Enter your comment.
- Click Post.
From our good friends over at the Sun xVM Ops Center team, see the How to comment on a Sun Wiki page screencast for a visual, step-by-step tutorial.
Looking forward to your comments, and I'll be back again soon with some more documentation goodness.
(BTW, if you are wondering why I've included a picture of a koala bear, I don't have a good answer for you. I like when blogs have pictures and I didn't have one to provide. So, I thought I would give you a random koala bear picture. It's hard not to smile when you see one of these marsupials. Again, I'm all about the nurturing....)