requestFullScreen - make transient user activation obvious

[hamishwillee]

Issue #22303 states that transient user activation is not mentioned. That is incorrect - but it clearly isn't visible enough or the issue wouldn't have been posted.

I have moved it to the description. @foolip - work for you?

Fixes #22303

[github-actions]

Preview URLs

• /en-US/docs/Web/API/Element/requestFullscreen

[Elchi3]

I introduced a "Security" section in #20435 and applied it consistently throughout API docs that require user activation. I think the real bug here is how to better display security requirements and I'm not sure this one off fix is addressing it. It certainly doesn't help with consistency in the docs.

#20435 also contains some more discussion on this but it hasn't been followed up on yet.

[hamishwillee]

@Elchi3 OK, so if the information is provided as intended, then the linked issue is not a bug. I have closed it.

But how do you want to propose following up with making the security section more visible? A discussion thread, so at least it is visible?

Easiest quick fix would be to move this section up to just below the description. The argument for this would be the same as for having secure_context macro in the header.

My instinct is that much of the security stuff is boilerplate, and might be better autogenerated from front matter data. So for example you'd have data (true, false, maybe with a comment) for: transient user activation, secure context, user permission, etc.
From that you might generate a section and boilerplate text, possibly with icons or headers at the top of the page.

PS I'll close this PR once there is a place for discussing the problem. Note, I'd be happy to create this, but I can see you already have some thoughts.

[Elchi3]

@Elchi3 OK, so if the information is provided as intended, then the linked issue is not a bug. I have closed it.

But how do you want to propose following up with making the security section more visible? A discussion thread, so at least it is visible?

Yes, I think the front matter ideas from #20435 should be a discussion. I opened one in mdn/mdn-community#288

[hamishwillee]

Cheers. Closing this then.