mdn / content

The content behind MDN Web Docs
https://developer.mozilla.org
Other
9.22k stars 22.5k forks source link

Unify desc format for SVG elements #36883

Open skyclouds2001 opened 1 day ago

skyclouds2001 commented 1 day ago

Description

Motivation

Additional details

Related issues and pull requests

github-actions[bot] commented 1 day ago
Preview URLs (40 pages) - [`/en-US/docs/Web/SVG/Element/a`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/a) - [`/en-US/docs/Web/SVG/Element/animateMotion`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/animateMotion) - [`/en-US/docs/Web/SVG/Element/animateTransform`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/animateTransform) - [`/en-US/docs/Web/SVG/Element/animate`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/animate) - [`/en-US/docs/Web/SVG/Element/defs`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/defs) - [`/en-US/docs/Web/SVG/Element/desc`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/desc) - [`/en-US/docs/Web/SVG/Element/ellipse`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/ellipse) - [`/en-US/docs/Web/SVG/Element/feColorMatrix`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/feColorMatrix) - [`/en-US/docs/Web/SVG/Element/feDistantLight`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/feDistantLight) - [`/en-US/docs/Web/SVG/Element/feDropShadow`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/feDropShadow) - [`/en-US/docs/Web/SVG/Element/feFlood`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/feFlood) - [`/en-US/docs/Web/SVG/Element/feMergeNode`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/feMergeNode) - [`/en-US/docs/Web/SVG/Element/feMerge`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/feMerge) - [`/en-US/docs/Web/SVG/Element/feOffset`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/feOffset) - [`/en-US/docs/Web/SVG/Element/fePointLight`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/fePointLight) - [`/en-US/docs/Web/SVG/Element/font-face-name`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/font-face-name) - [`/en-US/docs/Web/SVG/Element/glyphRef`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/glyphRef) - [`/en-US/docs/Web/SVG/Element/glyph`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/glyph) - [`/en-US/docs/Web/SVG/Element/image`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/image) - [`/en-US/docs/Web/SVG/Element/line`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/line) - [`/en-US/docs/Web/SVG/Element/linearGradient`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/linearGradient) - [`/en-US/docs/Web/SVG/Element/marker`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/marker) - [`/en-US/docs/Web/SVG/Element/mask`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/mask) - [`/en-US/docs/Web/SVG/Element/mpath`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/mpath) - [`/en-US/docs/Web/SVG/Element/pattern`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/pattern) - [`/en-US/docs/Web/SVG/Element/polygon`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/polygon) - [`/en-US/docs/Web/SVG/Element/radialGradient`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/radialGradient) - [`/en-US/docs/Web/SVG/Element/rect`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/rect) - [`/en-US/docs/Web/SVG/Element/script`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/script) - [`/en-US/docs/Web/SVG/Element/set`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/set) - [`/en-US/docs/Web/SVG/Element/stop`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/stop) - [`/en-US/docs/Web/SVG/Element/style`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/style) - [`/en-US/docs/Web/SVG/Element/svg`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/svg) - [`/en-US/docs/Web/SVG/Element/symbol`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/symbol) - [`/en-US/docs/Web/SVG/Element/textPath`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/textPath) - [`/en-US/docs/Web/SVG/Element/text`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/text) - [`/en-US/docs/Web/SVG/Element/title`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/title) - [`/en-US/docs/Web/SVG/Element/tspan`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/tspan) - [`/en-US/docs/Web/SVG/Element/view`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/view) - [`/en-US/docs/Web/SVG/Element/vkern`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/vkern)
External URLs (2) URL: [`/en-US/docs/Web/SVG/Element/feColorMatrix`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/feColorMatrix) Title: `` - (1 time) (Note! This may be a new URL 👀) --- URL: [`/en-US/docs/Web/SVG/Element/vkern`](https://pr36883.content.dev.mdn.mozit.cloud/en-US/docs/Web/SVG/Element/vkern) Title: `` - (1 time) (Note! This may be a new URL 👀)
bsmth commented 1 day ago

Thanks for this! I'm going to anticipate that Hamish will suggest also updating the SVG element page template to be explicit about this if we're going ahead with this format. I've updated the HTTP header template page with a quote block with how we expect the first sentence should look if you want to use that for inspiration.

edit: also adding in Pepelsbey who might have opinions on the SVG intro format :)