Skip to content

Document missing API pages supported by 3 engines  #152

@teoli2003

Description

@teoli2003

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:

  1. 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.
  2. Missed features scattered on the rest of the specs.** They have been missed during the documentation efforts over the years.
  3. 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.

Metadata

Metadata

Labels

h1 2023Projects for the first half of 2023

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions