Fabian Guisset <[EMAIL PROTECTED]> wrote in message news:<[EMAIL PROTECTED]>... > Jayesh Sheth wrote:
[my re-jig bdt] > > Greetings, > Hi Jayesh, > > I was wondering what system Mozilla.org uses to write and maintain > > documentation. In what ways can people help out with documentation? > > Where is help needed most (with regards to documentation)? > If you want I can point you at the technical documentation we could > need. Not sure about the end-user documentation though. It'd be nice if that sort of information was available, even if only as comments on the documentation bugs (is there a tracking bug?). I've been following this: http://bugzilla.mozilla.org/buglist.cgi?bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&email1=&emailtype1=substring&emailassigned_to1=1&email2=&emailtype2=substring&emailreporter2=1&bugidtype=include&bug_id=&changedin=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&component=Documentation&short_desc=&short_desc_type=allwordssubstr&long_desc=&long_desc_type=allwordssubstr&bug_file_loc=&bug file_loc_type=allwordssubstr&status_whiteboard=&status_whiteboard_type=allwordssubstr&keywords=&keywords_type=anywords&field0-0-0=noop&type0-0-0=noop&value0-0-0=&cmdtype=doit&namedcmd=bookmark+keyword&newqueryname=&order=Reuse+same+sort+as+last+time heh heh ain't bugzilla sweet 'n' cuddly? *grin* > > Since most of the pages at Mozilla.org are aimed at technology > > professionals ( or people who already are familiar with Mozilla), I > > feel there is a need for another website, which could provide a > > gentler introduction to Mozilla without having to use words such as > > "binaries", "horked", "xpcom", or "branch-build." > Currently we are focusing on the new website (moz.zope.org) which will > hopefully lower the entry barrier to writing documentation (no longer > need the cvs beast). We also have contacts with people interested in > acting as documentation manager for the mozilla project, so hopefully > that will make it better. One of the benefits of good documents is that the user actually becomes more vigorous, rather than more fragile. *restrains self from poking M$ yet again* I can't expect "horked" to become mundane vernacular, and I seriously hope that XPCOM and such only arise as-needed ... not triffling stuff, but anyone who's encountered Mozilla-the-project had best be able to cope with such as "binaries" and "branch-build". If folks don't understand the difference between a nightly and a milestone, then it's tech_docs' responsibility to clarify that *I'm resisting the urge to use "empower" anywhere here* rather than contributing to a situation where stupification is the norm. That's the sort of distinction that tech_docs implements and makes part of the site / user experience. > > I am thinking about creating a Tips and Tricks page for Mozilla, > > which will be aimed at the average computer/Internet user, and not > > necessarily at people who are already very familiar with Mozilla. What > > kind of tips and tricks would be most useful to people on such a site. > as you have noticed, there is currently no real structure or tools for > documentation. This is a known problem and we are trying to find > solutions but it's not easy. I can't speak with authority on this, but I bet Mozillazine would publish good articles of this sort. Point being, approaching that group directly contributes to the work and clarifies matters that may be felt by many who are hanging back, whereas philosophical discussions are by their nature endless. > > Any thoughts or comments? > It has also been proposed in this newsgroup to use wikiweb, but I don't > think that has been investigated yet. > Basically if you want things to advance, you have to take initiatives, > otherwise nothing will be done at this point. ^5 to Fabian on this: OpenSource _gestalt_ is that the user/developer dichotomy gets crumbled ... if ya feel like there's a need for a certain document, or that a certain doc should be written a different way in a different style with a difference vernacular, well _thar' ya go!_ (CVS the monster is like a junk-yard dog ... a daily hastle, but a must-have when the need is real.) > > Regards, > > - Jayesh > -Fabian. hfx_ben
