html/template: document that comments are stripped from html templates

[hellozee]

The existing documentation doesn't document that the comments are
stripped from HTML templates after they are parsed. This patch tries
to document the behavior and provide a rationale along with a workaround
for that.

Fixes #28628

[gopherbot]

This PR (HEAD: 08bd49a) has been imported to Gerrit for code review.

Please visit https://go-review.googlesource.com/c/go/+/148833 to see it.

Tip: You can toggle comments from me using the comments slash command (e.g. /comments off)
See the Wiki page for more info

[gopherbot]

Message from Ian Lance Taylor:

Patch Set 1:

(1 comment)

---

Please don’t reply on this GitHub thread. Visit golang.org/cl/148833.
After addressing review feedback, remember to publish your drafts!

[gopherbot]

Message from Kuntal Majumder:

Patch Set 1:

Patch Set 1:

(1 comment)

The issue required the explanation and a possible workaround, what would be the best possible place to put them?

---

Please don’t reply on this GitHub thread. Visit golang.org/cl/148833.
After addressing review feedback, remember to publish your drafts!

[gopherbot]

Message from Ian Lance Taylor:

Patch Set 1:

The issue required the explanation and a possible workaround, what would be the best possible place to put them?

It may be appropriate to add something to the package docs. Or better might be to add an example.

Note that we don't have to do exactly what the issue says, we have to find the right fix.

Thanks.

---

Please don’t reply on this GitHub thread. Visit golang.org/cl/148833.
After addressing review feedback, remember to publish your drafts!

[gopherbot]

Message from Kuntal Majumder:

Patch Set 1:

Patch Set 1:

The issue required the explanation and a possible workaround, what would be the best possible place to put them?

It may be appropriate to add something to the package docs. Or better might be to add an example.

Note that we don't have to do exactly what the issue says, we have to find the right fix.

Thanks.

Ohh, sure, will reformat the patch accordingly

Thanks

---

Please don’t reply on this GitHub thread. Visit golang.org/cl/148833.
After addressing review feedback, remember to publish your drafts!

[gopherbot]

Message from Andrew Ekstedt:

Patch Set 1:

(2 comments)

---

Please don’t reply on this GitHub thread. Visit golang.org/cl/148833.
After addressing review feedback, remember to publish your drafts!

[gopherbot]

This PR (HEAD: f682ca8) has been imported to Gerrit for code review.

Please visit https://go-review.googlesource.com/c/go/+/148833 to see it.

Tip: You can toggle comments from me using the comments slash command (e.g. /comments off)
See the Wiki page for more info

[gopherbot]

Message from Roberto Clapis:

Patch Set 2:

(3 comments)

---

Please don’t reply on this GitHub thread. Visit golang.org/cl/148833.
After addressing review feedback, remember to publish your drafts!

[gopherbot]

Message from USE [email protected] instead:

Patch Set 2:

(3 comments)

---

Please don’t reply on this GitHub thread. Visit golang.org/cl/148833.
After addressing review feedback, remember to publish your drafts!