157610 - convert Gecko DOM API Reference source files to DocBook XML

Status: RESOLVED WONTFIX

(Documentation Graveyard :: Web Developer, defect)

Description

[Ian Oeschger (gone)]

The document begs for some format that makes it more accessible to contributors
and collaborators.
Single-threading-through-the-guy-whose-company-bought-him-Framemaker is getting
kind of cumbersome. Plus I'd like some practice using DocBook in a more involved
way, and for a large reference.

Comment 1

[Gérard Talbot]

I'd like to express my *_unconditional_* support for solving bugs which
- impedes the overall mozilla.org projects
- affects (directly or indirectly) the quality, reliability, usability of
reference docs
- consumes unnecessarly a lot of volunteer time when alternative (and more
optimal) tools, format, protocols could do a significant difference in many areas

The whole spirit (its foundation, working protocols, structures,etc.) of
mozilla.org is based on multi-lateral contributions and interoperability among
machines, platforms, devices, operating systems, languages, internet protocols, etc.

Fixing bug 157610 will not solve all the problems related to docs and
documentation in mozilla.org. But it sure should solve a few functioning
difficulties which "slow down" the working order of writing-publishing-updating
cycle.

Comment 2

[Isaac Rabinovitch]

There's no NEED HELP on this bug, but it's been hanging fire for some months. I
have some XML experience, and need more. Can I have this project?

Comment 3

[John Keiser (jkeiser)]

Isaac: I would email [e-mail] directly to ask, if I were you, but
it's a fair bet you can just work on this, yeah--if there were activity it would
be posted in the bug.

Comment 4

[Ian Oeschger (gone)]

Working on it. Isaac and I have been talking about this some, and I've been
trying to put some stylesheets together that will get XML from FrameMaker and
put it into passable DocBook:

http://www.brownhen.com/XML/fm2doc.html
http://www.brownhen.com/XML/fm2doc.xsl.txt

Comment 5

[Ian Oeschger (gone)]

moving stuff over to an outside-the-firewall email for the time being, looking
for people to pick these Help and doc bugs up for me.

Comment 6

[Daniel Wang]

-> Doron

Comment 7

[Doron Rosenberg (IBM)]

I don't think DocBook is what we need.  I prefer a more semantic structure. 
Probably need to create our own :)

Comment 8

[Doron Rosenberg (IBM)]

or maybe we should use docbook.  dunno :)

Comment 9

[Yuh-Ruey Chen]

Devmo to the rescue :)

Comment 10

[Yuh-Ruey Chen]

oops wrong resolution