Just created bug 145056 to put a new top-level item in the Mozilla Help table of contents: Mozilla Tools and Development. May want to change the wording, and the content itself--a new file called moz_tools.html to be added in the patch--is just a placeholder. Thought this would be a good container for documents that are missing currently from the help.
.i Ian Oeschger wrote: > 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? >> >> >
