Comment 1:

I am not sure we really want people writings sentences as identifiers.
You can write a doc comment and godoc will show it as explanatory text.

Labels changed: added priority-later, removed priority-triage.

Owner changed to @adg.

Status changed to Accepted.

Comment 2 by trolleriprofessorn:

Yes, it's a bit weird that the method name is transformed into a heading in
the documentation. Perhaps another mechanism for creating the headings
would be better.

Comment 4:

[The time for maybe has passed.]

Comment 5:

Labels changed: added godoc.

Comment 6:

Labels changed: added go1.3maybe.

Comment 7:

Labels changed: added release-none, removed go1.3maybe.

Comment 8:

Labels changed: added repo-tools.

Currently, godoc ignores example functions if their suffixes contain _ as it messes up with the example association logic with its corresponding function/type/method.

Although the logic can be extended to support suffixes containing '_', I don't see much value in this. The use of _ is very clear in demarcating boundaries between methods on a type and the suffix (for eg. ExampleT_M_suffix and ExampleT_suffix). We have been doing fine with single word suffixes using CamelCase for extra distinction (ExampleT_M_suffixAnother).

And given that it has remained dormant for 5 years, I doubt there is any need for it. Thoughts @bradfitz / @andybons ?

ping ?