diff --git a/docs/configuration.md b/docs/configuration.md
index eab54bc..1224ba7 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -287,6 +287,7 @@ theme:
 > .widget-type-rss a {
 >     font-size: 1.5rem;
 > }
+> ```
 >
 > In addition, you can also use the `css-class` property which is available on every widget to set custom class names for individual widgets.
 
@@ -1045,7 +1046,7 @@ Display a widget provided by an external source (3rd party). If you want to lear
 | parameters | key & value | no | |
 
 ##### `url`
-The URL of the extension.
+The URL of the extension. **Note that the query gets stripped from this URL and the one defined by `parameters` gets used instead.**
 
 ##### `fallback-content-type`
 Optionally specify the fallback content type of the extension if the URL does not return a valid `Widget-Content-Type` header. Currently the only supported value for this property is `html`.
diff --git a/docs/preconfigured-pages.md b/docs/preconfigured-pages.md
index b382917..b70610b 100644
--- a/docs/preconfigured-pages.md
+++ b/docs/preconfigured-pages.md
@@ -4,6 +4,10 @@ Don't want to spend time configuring pages from scratch? No problem! Simply copy
 
 Pull requests with your page configurations are welcome!
 
+> [!NOTE]
+>
+> Pages must be placed under a top level `pages:` key, you can read more about that [here](configuration.md#pages).
+
 ## Startpage
 
 ![](images/startpage-preview.png)