diff --git a/wit/sensor.wit b/wit/sensor.wit
index 5454ba0..b638b2a 100644
--- a/wit/sensor.wit
+++ b/wit/sensor.wit
@@ -22,7 +22,7 @@ interface sensor {
       unknown
   }
 
-  // Sensor device
+  /// Sensor device
   resource device {
       /// open the device.
       /// this might power on the device.
diff --git a/wit/world.wit b/wit/world.wit
index 758f9a5..af9a577 100644
--- a/wit/world.wit
+++ b/wit/world.wit
@@ -1,10 +1,3 @@
-// If the repository defines `interface`s, this file can define a minimal world
-// which contains those interfaces, to allow documentation to be generated for
-// them.
-//
-// Proposals should remove these `//` commments, and edit the `world` name and
-// imports below to pull in their own `interface`s.
-
 package wasi:sensor;
 
 world sensing {