OWD Project Proposal: SVG docs need some love

[Rumyra]

SVGs are common place and there's a few parts of the docs which highlight the time is which these docs were first written. There's a lot of good stuff, but re-considering page structure and removing unnecessary docs would be good.

• Reconsider element & attribute page data structure - element pages list all global attributes - do they need to? https://developer.mozilla.org/en-US/docs/Web/SVG/Element/circle
• Tutorials need more exposure - also this page either needs more or other sections to be removed https://developer.mozilla.org/en-US/docs/Web/SVG/Tutorial (I would personally love to see some SVG filter tutorials)
• Other pages also don't have a lot of exposure/x-linking https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/Presentation
• Lots of references to SVG 1.1 - should possibly update these to 2
• Lots of things removed https://developer.mozilla.org/en-US/docs/Web/API/Document_Object_Model#svg_interfaces and depreciated https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/ascent
• Some things now irrelevant: https://developer.mozilla.org/en-US/docs/Web/SVG/Server-configuration

Is there a way to better marry presentational attributes with CSS properties?

Effort

There's quite a few things to address, so probably a large effort. However the SVG docs are pretty complete.

Dependancies

No changes to the platform should be needed

Community

Not sure if there's much engagement to be had

Momentum

My concern is it's a catch 22 - there's some good stuff in the SVG docs which is possibly going un-noticed

Enabling learners

Would be good to refresh the tutorials and make them more discoverable

Enabling professionals

A more structured approach to the ref docs would help

Underrepresented topics / ethical web

N/A

Operational necessities

N/A

Addressing needs of the Web industry

Making SVG docs better for everyone 💅

[Rumyra]

This needs some fleshing out - which I propose to do within this issue. Some notes so I don't forget

• bcd
• fold attributes into elements
• more exposure
• delete irrelevant pages
• plan to match attr with related css

Also there's interfaces eg https://developer.mozilla.org/en-US/docs/Web/API/SVGPathElement

Update: I don't foresee this happening until I've created a better plan 👍

[Rumyra]

I've captured this here mdn/mdn#176 as I think it's needs a domain expert (which is on my roadmap for the future) hence I'm closing this 👍