diff --git a/docs/resources/contributing.md b/docs/resources/contributing.md index de80580a..d02e8dc5 100644 --- a/docs/resources/contributing.md +++ b/docs/resources/contributing.md @@ -230,6 +230,18 @@ A pattern has been established in `` and `` for expand There should be a container element immediately surrounding both slots. The container should be animated with CSS by default and it should have a part so the user can override the animation or disable it. Please refer to the source and documentation for `` and/or `` for details. +### Fallback Content in Slots + +When providing fallback content inside of `` elements, avoid adding parts, e.g.: + +```html + + + +``` + +This creates confusion because the part will be documented, but it won't work when the user slots in their own content. The recommended way to customize this example is for the user to slot in their own content and target its styles with CSS as needed. + ### Custom Events Components must only emit custom events, and all custom events must start with `sl-` as a namespace. For compatibility with frameworks that utilize DOM templates, custom events must have lowercase, kebab-style names. For example, use `sl-change` instead of `slChange`.