Re: Thoughts on updating MathML documentation

Robert O'Callahan <[email protected]> Wed, 24 Mar 2010 22:26:17 +1300
Newsgroups gmane.comp.mozilla.devel.mathml
Organization Mozilla Corporation
Message-ID <[email protected]>
On 22/03/10 7:36 AM, Frédéric Wang wrote:
> (1) wiki.mozilla.org, used to plan and document the development. There
> is currently no entry for MathML.
> (2) developer.mozilla.org, used to describe Mozilla/Web technologies for
> developers. There is only one and very incomplete entry for MathML.
> (3) www.mozilla.org/projects/mathml, the MathML project homepage.
>
> Ideally, I think we should really keep in (3) an overview of the
> project: link to mozilla's resources (newsgroups, (1) and (2))
> information for users of mozilla products (essentially, the installation
> of fonts), updates and general roadmap. Demos, links to MathML software
> tools, guidelines for authoring etc should be moved to the wiki (2) and
> can be completed by contributors (however it may currently not be
> possible to move demos because of the requirement to serve pages as
> XHTML). Status of the development can be moved in (1) or (2) (or both?).
> The text from 1999 can be removed from the frontpage (probably kept
> separately for nostalgic people) and replaced by a short description of
> the status of project. In that way, the project page will not need to be
> updated so often as opposed to wiki (which are more convenient for
> contributors).

I think that's a good plan, but I think we should go further and move 
everything to the wiki and make mozilla.org/projects/mathml redirect to 
the wiki page. For now we can simply link back to the www.mozilla.org 
pages for the demos. In the slightly longer term, when the HTML5 parser 
is enabled by default we should ensure we can put MathML in the wiki 
HTML markup!

Rob