Re: [svgwg] Use <dfn> for definitions

If you're not using bikeshed, set the type of a `<dfn>` by using a `data-dfn-type` attribute with one of [these values](https://tabatkins.github.io/bikeshed/#dfn-types).

[These types](https://tabatkins.github.io/bikeshed/#dfn-for) need a `data-dfn-for` attribute with the name of the namespace. e.g. `<dfn data-dfn-type='element-attr' data-dfn-for='img'>src</dfn>`.

You may also want to specify [linking text](https://tabatkins.github.io/bikeshed/#changing-lt) with `data-lt` when the contents of the `<dfn>` aren't exactyl what people want to link to.

Note that the spec parser does have some heuristics and will infer missing `<dfn>` types from enclosing classes, micro-syntaxes in `<dfn>` values, etc. But it's always better to have explicit data attributes.

If you do use bikeshed, it will generate the data-dfn-* attributes for you, but you still need to specify the types and namespaces, the syntax is just simpler, e.g. `<dfn element-attr for='img'>src</dfn>`

-- 
GitHub Notification of comment by plinss
Please view or discuss this issue at https://github.com/w3c/svgwg/issues/417#issuecomment-383271681 using your GitHub account

Received on Saturday, 21 April 2018 06:29:06 UTC