I'd love to take additions to the help files on the mozilla side. Jayesh has done a great thing by organizing these checklists, and I have already used them to make some much-needed updates to the Mozilla Help.
Recently, as I've been going through the UI and trying to hook Help buttons up to context-sensitive help, I've found a number of mozilla-only topics for which there is no documentation: Beyond the prefs themselves, the DOM Inspector, Debugging Events, Debugging Networking--a lot of these more technical tools or topics either don't appear in Netscape or haven't been addressed yet. Brant Gurganus has written bugs against me for the buttons (see the list in http://bugzilla.mozilla.org/show_bug.cgi?id=129540#c49), and I have hooked up a few in a patch in that same bug, but for many I've had to kick it up to the Welcome page because there *was* no context. The list of undocumented and somewhat nerdier pref panels is at least one good source of inspiration for what needs to be written, and may suggest a clump of sysadmin-like topics that we could organized as a new document. Also, I think we tried to say something about doc format on the www.mozilla.org/docs/mdp page, and of course the existing Help docs are a pretty good model for topic-based stuff. -i Jayesh Sheth wrote: > Huw, > > Thanks for your follow-up. Glad to hear you're migrating from 4.x! And > sorry about the fact that there is no existing "migration" > documentation. > > About a standard format: not that I know of. I think as long as the > documentation is proof-read and understandable, it should be okay (I > may be wrong here, maybe Ian Oeschger knows better in this case ...) > > I any case, feel free to email me the document : moztips at emailias > dot com . Maybe Ian will consider adding it to Mozilla's help file, > since this seems to be a valid issue which seems to have been > neglected. > > Thanks for your opinion and offer of help! > > Regards, > > - Jayesh > Huw Lynes <huw-l@moving-picture> wrote in message >news:<3CC938D1.8090901@moving-picture>... > > >>Aha, a starting point. However the big-gap in documentation would seem >>to be that there is nothing aimed at sysadmins. Nothing about >>centralised installation issues and automating account setups. Not even >>a quick guide through the format of the preferences files. I only >>mention this as a sysadmin who is currently shifting a system from NS4.7 >>to Moz and having to write the documentation as I go. See my post to >>n.p.m.prefs if you are interested in the problem. >> >>Anyway once I've got the docs written I'd be happy to post them. Is >>there a standard format, and a person to post them to? >
