diff --git a/docs/formats/webextension.rst b/docs/formats/webextension.rst
index 7d06c9112f74..f1b8498ee643 100644
--- a/docs/formats/webextension.rst
+++ b/docs/formats/webextension.rst
@@ -7,9 +7,9 @@ File format used when translating extensions for Mozilla Firefox or Google Chrom
 
 .. note::
 
-    While this format is called JSON, its specification allows to include
-    comments, which are not part of JSON specification. Weblate currently does
-    not support file with comments.
+   While this format is called JSON, its specification allows including
+   "//"-style comments. Weblate does strip these comments while parsing the
+   files and discards them when saving.
 
 .. seealso::