diff --git a/docs/guidelines/10-guidelines-definitions.md b/packages/core/docs/guidelines/10-guidelines-definitions.md
similarity index 100%
rename from docs/guidelines/10-guidelines-definitions.md
rename to packages/core/docs/guidelines/10-guidelines-definitions.md
diff --git a/docs/guidelines/20-guidelines-styling.md b/packages/core/docs/guidelines/20-guidelines-styling.md
similarity index 100%
rename from docs/guidelines/20-guidelines-styling.md
rename to packages/core/docs/guidelines/20-guidelines-styling.md
diff --git a/docs/guidelines/30-guidelines-scoped-elements.md b/packages/core/docs/guidelines/30-guidelines-scoped-elements.md
similarity index 100%
rename from docs/guidelines/30-guidelines-scoped-elements.md
rename to packages/core/docs/guidelines/30-guidelines-scoped-elements.md
diff --git a/docs/guidelines/40-guidelines-subclasser-apis.md b/packages/core/docs/guidelines/40-guidelines-subclasser-apis.md
similarity index 100%
rename from docs/guidelines/40-guidelines-subclasser-apis.md
rename to packages/core/docs/guidelines/40-guidelines-subclasser-apis.md
diff --git a/docs/rationals/001-side-effects.md b/packages/core/docs/rationales/001-side-effects.md
similarity index 100%
rename from docs/rationals/001-side-effects.md
rename to packages/core/docs/rationales/001-side-effects.md
diff --git a/packages/core/src/DelegateMixin.js b/packages/core/src/DelegateMixin.js
index a83497ecf..04f5ee9a1 100644
--- a/packages/core/src/DelegateMixin.js
+++ b/packages/core/src/DelegateMixin.js
@@ -17,6 +17,7 @@ import { dedupeMixin } from '@open-wc/dedupe-mixin';
  *     attributes: ['disabled'],
  *   };
  * }
+ *
  * render() {
  *   return html`
  *     <button id="button1">with delegation</button>