Thoughts on updating MathML documentation

Frédéric Wang <[email protected]> Sun, 21 Mar 2010 19:36:47 +0100
Newsgroups gmane.comp.mozilla.devel.mathml
Message-ID <[email protected]>
Hi all,

In a previous thread, some people complained about the fact that the 
MathML project page are outdated and doesn't show what is currently made 
on MathML implementation. Update of MathML documentation was also 
mentioned. Since then, I've worked on bug triage for MathML: I've closed 
duplicate bugs or very old bugs that were no longer valid, I've open new 
bugs (in particular regarding the features of MathML 3) and added 
dependencies to improve organization. I've also worked on some MathML 
bugs and fixed a few of them. I think I've now a better understanding of 
the MathML code and I'm able to propose a roadmap for the MathML 
project. Hence I plan to add documentation for contributors (i.e. in (1) 
below). If I understand well, the documentation is organized as follows:
	
(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).

FYI, I've opened bug 553915.