> a b wrote: > >> 1. Documentation is a major pain in the ass to > find. Outside of man > >> pages and the occasional Sun engineer blog entry, > there seems to be > >> no decent documentation. In fact, most people > admit that the "Solaris > >> 10" books that are currently out, are simply > Solaris 9 books with a > >> new cover. How is a user who asks "is there a > equivalent" supposed to > >> actually find out if it exists? > > > > Personally, I find docs.sun.com to be an > outstanding source of > > documentation, especially on some very obscure > technologies in Solaris. > > > > Yes, there have been times when I wished that there > were more > > examples, and when I wished that the search engine > was better, but > > overall, docs.sun.com has top-notch content against > which many other > > computer companies can measure themselves. The > documentation is > > extremely well organized and structured. > (docs.hp.com and > > techpubs.sgi.com are comparable in that regard.) > > > You admit that docs.sun.com leaves something to > desire. I'm not > advocating throwing everything out .... simply making > it easier to use, > find and getting howtos and the like. I also > understand that a huge part > of that is the community helping out ... and it'll > get there, it's just > my opinion that the importance of documentation and > the effort of > improving it needs to be at the forefront of > everyone's mind. > Hi,
We welcome all of your comments and feedback on documentation on the docs-discuss list for OpenSolaris, that is where documentation is at the forefront of discussion and minds. I post to that list the SX manuals that change each month, or you can watch osol-announce for that information too. 26 manuals are open source and can be dowloaded here: http://opensolaris.org/os/downloads/docs We also have a number of new projects going, some interesting stuff for folks who care about docs. Come join us, we can always use lots of help. Thanks, Michelle This message posted from opensolaris.org _______________________________________________ opensolaris-discuss mailing list [email protected]
