-
-
Notifications
You must be signed in to change notification settings - Fork 41
Closed
Labels
h1 2023Projects for the first half of 2023Projects for the first half of 2023
Description
Problem statement
There are missing docs in MDN Web/API documentation. We would like to increase the coverage here so that we can guarantee that each feature supported by three engines is documented.
There are three groups of missings docs:
- Numerous features related to HTML and SVG specs that often (but not always) are deprecated or properties reflecting attributes. We don't have them documented because we never prioritized their writing.
- Missed features scattered on the rest of the specs.** They have been missed during the documentation efforts over the years.
- We also have a few WebGL, Geometry Interfaces, and WebAssembly features that are not individually documented (like
WebGLRenderingContext.uniform[1234][fi][v]that are documented, on purpose, in one page, or under another hierarchy (like WebAssembly).
Proposed solutions
The goal of this project is to
- Add the missing features under 2. (non-HTML and SVG features, currently 78 missing features)
We would take the baseline for the three-engine supports as Feb 1st, 2023.
Task list
- Document the 78 missing features as listed here. (Fix point 2.)
Note: we finally documented 104 pages!
Priority assessment
- Effort: 78 pages means about 8 to 12 weeks of work
- Dependencies: None.
- Community enablement: Yes, this has the potential to attract significant community help
- Momentum: Yes, the mdn-gaps website allows us to detect missing documents easily
- Enabling learners: Yes, HTML*Element are APIs that are used a lot by beginners
- Enabling professionals: Yes, professionals will be sure to have all features they can use documented
- Underrepresented topics / Ethical web: N/A
- Operational necessities: None
- Addressing needs of the web industry: Yes, MDN would be the only place that can claim to have all API supported by the three engines documented.
More information
This project aims at creating good quality new documents but doesn't aim at fixing current documents.
This project doesn't aim at documenting all HTML*Element and SVG*Element features, but to unblock community members so they can help us.
The choice of documenting features supported by 3 engines has been taken in order to keep this project small enough so it can be done.
Reactions are currently unavailable
Metadata
Metadata
Labels
h1 2023Projects for the first half of 2023Projects for the first half of 2023