Clarify differences between Presentation and Content MathML
Nobody has claimed this yet.
- Dominant language
- Julia
- Stars
- 26
- Forks
- 10
- Avg merge
- 42m
- Merged PRs (30d)
- 5
Description
AI Disclosure: This issue was drafted with the assistance of an AI language model.
Is your feature request related to a problem? Please describe.
The current README does not clearly explain the differences between Presentation MathML (visual rendering) and Content MathML (semantic meaning), nor which subsets are supported. This may causes confusion for users who want to:
- Generate MathML for browsers.
- Parse existing MathML documents.
- Understand the limitations of MathML.jl.
Describe the solution you’d like
Update the README to:
- Add a "MathML Subsets" section with a table of supported/unsupported tags.
- Include comparative examples for Presentation vs. Content MathML.
- Add a FAQ section addressing common questions (e.g., "Why doesn’t MathML.jl support Presentation MathML?").
Describe alternatives you’ve considered
- Relying on external documentation (e.g., W3C specs).
→ Problem: External docs don’t cover MathML.jl’s specific limitations.
Additional context
- Priority: ⭐⭐⭐ (Low effort, high impact for usability).
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the README and inspect MathML.jl's parser behavior to verify which Presentation and Content MathML tags are supported. Document the confirmed subsets in a table, add comparative examples and the requested FAQ, and ensure the README accurately explains the project's limitations for generation and parsing.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- julia
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 74/100