Communications Suite Docs What If? Redux

Re: my post from Monday, how would the Comms Community like a wiki-based documentation solution apropos of what OpenDS is providing on its wiki doc site? Evidentally, this is "the" documentation site; all the information normally found on a product doc repository, such as our docs.sun.com, is instead located on this wiki.

I see a lot of advantages to this model, including: community contribution/participation; more timely doc updates; ability to find out better what information matters most to customers; and so forth.

Comments:

I love to see the gears turning and you guys thinking of better ways to deliver information to the masses. You have been doing a great job through the use of the blogs and bigadmin to disseminate information. I am a follower of OpenDS and like the model of the wiki for the docs and think this is a good dea to look into. Anything is better than docs.sun.com, why so many problems with that? It takes forever to load a doc, and that is usually after hitting refresh 2-3 times, no where else do I have this problem.

I dont have any revolutionary ideas, but think you are heading down the right track with an open mind. That was an interesting idea from the earlier post comment from Michael about a "build your own" doc set from answering some basic questions, would be real helpful for the migration type information that varies widely.

Posted by Mike on October 10, 2007 at 12:00 PM MDT #

Mike,

We appreciate the feedback. We do have the feeling that a wiki-ized approach is the way to go.

What about hard copy though? Do you feel there are any docs or information that should also ship in PDF? Right now, seems that is an issue w/ info that only lives on a wiki, where you can't get a full book-like object in PDF.

Posted by Joe Sciallo on October 10, 2007 at 12:52 PM MDT #

I dont have a problem with the wiki approach and not having a pdf doc set, sometimes I cringe thinking of viewing the pdf doc set because of my many experiences of this having some errors in them(though for the most part they are very thorough just sometimes missing hte key items I am looking for).

I think you will meet resistance from some customers by not having a complete set of pdf docs that have the "stamp of approval". Even though the wiki approach I feel will provide a more complete set, especially with people in the field able to give their 2 cents worth into the docs.

Posted by Mike on October 15, 2007 at 10:27 AM MDT #

Post a Comment:
  • HTML Syntax: NOT allowed
About

Reporting about Unified Communications Suite Documentation, including news, Comms 101, documentation updates, and tips and tricks.

Search

Archives
« April 2014
SunMonTueWedThuFriSat
  
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
   
       
Today