_content/doc/comment: document form of directive comments
Fixes golang/go#43776.
Change-Id: I3e18dbe5dfb0bca96a16203efd4c2a92636cf412
Reviewed-on: https://go-review.googlesource.com/c/website/+/442516
Run-TryBot: Russ Cox <rsc@golang.org>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Ian Lance Taylor <iant@google.com>
diff --git a/_content/doc/comment.md b/_content/doc/comment.md
index f1e547c..4c8715e 100644
--- a/_content/doc/comment.md
+++ b/_content/doc/comment.md
@@ -490,6 +490,11 @@
//go:generate stringer -type Op -trimprefix Op
type Op uint8
+A directive comment is a line matching the regular expression
+`//(line |extern |export |[a-z0-9]+:[a-z0-9])`.
+Tools that define their own directives should use the form
+`//toolname:directive`.
+
Gofmt removes leading and trailing blank lines in doc comments.
### Paragraphs {#paragraphs}
