[Dialog] "content" slot name / description is confusing

[macandcheese]

Description

We've received feedback the "content" slot name and description is confusing.

Migrating from Modal - consumers are not changing this to the "default / unnamed" slot and have unexpected results.

Which Component

It's confusing for a few reasons... First, the "content" name is used elsewhere, and it never prevents the rendering of "component chrome" like it does here. Secondly, the description of "A slot for adding custom content." is not descriptive enough.

It should explicitly mention that content in this slot will prevent the rendering of the "component chrome" (except for box-shadow and corner-radius - which may be unexpected).

Because using this slot (the custom one, not the default / recommended one) is a low-occurance use case and the name currently used is so common elsewhere, I'd propose renaming (deprecate + adding replacement) to "custom-content" or something equally as literal, and having the description more clearly outline the behavior when used.

Resources

Feedback received from developer-users within Esri.