Set-Cookie attributes are now headers

[halvardssm]

Summary

For easier linking to each attribute, the Set-Cookie attributes are now headers.

Motivation

As I was writing some documentation for a personal project, I wanted to link to individual attributes for the Set-Cookie header. Unfortunately, as the attributes were a list, I was not able to do so, which is what motivated this change.

If this PR gets merged, it is the intention that I should be able to access each attribute with a direct link, e.g. https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#attribute

Supporting details

Related issues

Metadata

• Adds a new document
• Rewrites (or significantly expands) a document
• Fixes a typo, bug, or other error

[github-actions]

Preview URLs

• https://pr10730.content.dev.mdn.mozit.cloud/en-US/docs/Web/HTTP/Headers/Set-Cookie

Flaws

None! 🎉

External URLs

URL: /en-US/docs/Web/HTTP/Headers/Set-Cookie
Title: Set-Cookie
on GitHub

No new external URLs

[hamishwillee]

@halvardssm The format of the thousands of reference docs on MDN follows a standard template - attributes are done as a definition list.

@wbamberg "Generally" it is really convenient to be able to link to "whatever". I don't think there is any way we can accommodate this though?

[wbamberg]

@halvardssm The format of the thousands of reference docs on MDN follows a standard template - attributes are done as a definition list.

@wbamberg "Generally" it is really convenient to be able to link to "whatever". I don't think there is any way we can accommodate this though?

Not in general. For HTML element attributes we have the htmlattrdef macro, that adds anchors: https://github.com/mdn/content/blob/main/files/en-us/web/html/element/iframe/index.md?plain=1#L104, https://developer.mozilla.org/en-US/docs/Web/HTML/Element/iframe#attr-csp).

It has occurred to me before (when looking at the values for CSS properties) that we might be able to auto-generate IDs for <dt> elements in the markdown-to-HTML step, just like we do for headings. But I've not given it any real thought so I don't know if there would be any big issues with doing that.

[halvardssm]

@hamishwillee i see, thank you for letting me know.

It would be convenient to be able to link to whatever, so I am fully supporting the auto generation of ids (links).

As this PR will not get through either way, should I close it?

[wbamberg]

I've created mdn/yari#4990 to capture the suggestion to generate id attributes from <dt> elements, and yes, we should close this.