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.