diff --git a/news/1846.documentation b/news/1846.documentation
new file mode 100644
index 000000000..d46a5b681
--- /dev/null
+++ b/news/1846.documentation
@@ -0,0 +1 @@
+`html_use_opensearch` value must not have a trailing slash. Clean up comments. @stevepiercy