diff --git a/draft/webxdc-dev-reference.md b/draft/webxdc-dev-reference.md
index ae51646cd..d01daea2d 100644
--- a/draft/webxdc-dev-reference.md
+++ b/draft/webxdc-dev-reference.md
@@ -182,6 +182,8 @@ just clone and start adapting things to your need.
 - viewport and scaling features are implementation specific,
   if you want to have an explicit behavior, you can add eg.
   `<meta name="viewport" content="initial-scale=1; user-scalable=no">` to your Webxdc
+- the `<title>` tag should not be used and its content is usually not displayed;
+  instead, use the `name` property from `manifest.toml`
 - there are tons of ideas for enhancements of the API and the file format,
   eg. in the future, we will may define icon- and manifest-files,
   allow to aggregate the state or add metadata.