Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Include Temml as one of the MathML Tools. #22640

Closed
wants to merge 1 commit into from
Closed

Conversation

ronkok
Copy link

@ronkok ronkok commented Nov 30, 2022

Description

Add Temml as one of the tools available for MathML. Temml is a TeX math-to-MathML conversion library written in JavaScript.

Motivation

Temml has been written specifically for MathML-Core.

Additional details

GitHub repository is at: https://github.com/ronkok/Temml
Demonstration page: https://temml.org/
LaTeX support is shown at: https://temml.org/docs/en/supported.html

Temml is a TeX math-to-MathML conversion library written in JavaScript. It has been written specifically for MathML-Core.
@ronkok ronkok requested a review from a team as a code owner November 30, 2022 18:38
@ronkok ronkok requested review from fred-wang and removed request for a team November 30, 2022 18:38
@github-actions github-actions bot added the Content:MathML MathML docs label Nov 30, 2022
@ronkok ronkok changed the title Include Temml as one of the Tools. Include Temml as one of the MathML Tools. Nov 30, 2022
Copy link
Contributor

@fred-wang fred-wang left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks!

@hamishwillee
Copy link
Collaborator

Thanks @ronkok , but I'm actually going to reject this change.

Generally we try to avoid linking external tools and libraries at all on MDN. Too often they end up linking to unmaintained projects after a few years. The exceptions were we do link tend to be "defacto standards", larger projects that have a maintenance history, or "notable" projects that do something truly exceptional.

This project, while worthy does not meet those requirements.

@ronkok
Copy link
Author

ronkok commented Dec 5, 2022

@hamishwillee, those are valid concerns. Let's see how they apply here:

Too often they end up linking to unmaintained projects.

Texzilla has not been updated for three years. The recent changes from MathML 3.0 toward MathML-Core are therefore not adopted.

The exceptions were we do link tend to be "defacto standards"

The current version of MathJax, 3.x, no longer includes MathML as a native output. Their docs do give instructions on how to access an internal memory structure built in MathML, but that MathML is now used for internal purposes. They no longer expect it to be used to render math directly. That's if you can get an output using their instructions. My own attempts have failed.

MathJax can be said to be a "defacto standard", but it is today a standard for rendering math in HTML., not in MathML.

When Chromium supports MathML for the first time a month from now, we may actually begin to see MathML used in web pages. Creators of web pages deserve a tool that is up to date and built to purpose. That would be Temml.

Please reconsider your decision.

@fred-wang
Copy link
Contributor

I actually agree with @hamishwillee ; in a previous changes we had already removed many of existing tools and was a bit skeptical about approving it...

So my proposal would be to go one step further: Completely remove the "Tools" section from MDN. Note that SVG or HTML don't have something comparable. Instead we can just link to whichever page the Math WG thinks is relevant for MathML Core. That can be Math Tools or something else, but discussions about how to list and organize the tools can be performed in the WG. If people agree with that, I can prepare a PR.

Some more comments inline.

Texzilla has not been updated for three years. The recent changes from MathML 3.0 toward MathML-Core are therefore not adopted.

I believe this is not true, most of the MathML 3 simplifications were discussed in the Math CG in 2019 and integrated into TeXZilla already. I personally still plan to maintain TeXZilla. There is a little Mozilla story behind it because it is the successor of itex2MML, which was used in original demos of the Mozilla MathML project. But I'm fine if it is removed from the MDN list together with the other tools...

MathJax can be said to be a "defacto standard", but it is today a standard for rendering math in HTML., not in MathML.

I don't really know the recent status of the MathJax project and their plan with native MathML. I still had the impression that people continue to use it as a fallback for browsers without MathML support. If you are right that it's no longer relevant for MathML purpose then probably we should remove it too...

Creators of web pages deserve a tool that is up to date and built to purpose. That would be Temml.

I'm grateful that you and others are writing tools for MathML Core. I haven't tried Temml myself but my expectations is that developers will start to create or update tools to use MathML once it is released in Chrome. Perhaps I'm wrong, but I suspect there won't be one "defacto standard" to select, at least in the short term. I also don't think it's the role of MDN reviewers to judge what's the most relevant tools would be...

@bsmth
Copy link
Member

bsmth commented Dec 6, 2022

Hi all, thanks for chiming in here. Adding to @hamishwillee's point, the criteria for inclusion says that self-promoting external links will not be added. You can read more in our policies for what we write in our writing guidelines.

Thank you.

@fred-wang
Copy link
Contributor

I moved the discussion about MathML Core tools in the Math WG: https://lists.w3.org/Archives/Public/www-math/2022Dec/0009.html

Once we have a link of MathML Core tools, we can probably use it to replace the Tools section.

@bsmth Thanks. Good point too!

@ronkok ronkok deleted the patch-1 branch December 6, 2022 15:30
@ronkok
Copy link
Author

ronkok commented Dec 6, 2022

All very good points, and I accept them. I'm deleting this branch.

fred-wang added a commit to fred-wang/content that referenced this pull request Dec 8, 2022
wbamberg pushed a commit that referenced this pull request Dec 8, 2022
hamishwillee pushed a commit to hamishwillee/content that referenced this pull request Dec 12, 2022
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Content:MathML MathML docs
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants