diff --git a/providers/os/resources/os.lr b/providers/os/resources/os.lr
index 5c538a83db..caa3d844b2 100644
--- a/providers/os/resources/os.lr
+++ b/providers/os/resources/os.lr
@@ -20,11 +20,9 @@ extend asset {
   // Common Platform Enumeration (CPE) for the asset
   cpes() []core.cpe
   // Advisory & vulnerability report
-  // Deprecated; will be removed in version 12.0
-  // use vulnmgmt instead
+  // Deprecated; will be removed in version 12.0 (use vulnmgmt instead)
   vulnerabilityReport() dict
-  // Platform URL in the Package URL format
-  // That's a URL as alternative to the CPE format
+  // Platform URL in the package URL format (as opposed to the CPE format)
   purl() string
 }