Suggestion/question: couldn't go lint be changed to complain if explanations for the parameters are omitted?

Revently, I deliver products written in Go for my customers with godoc documentation. The documentation is written in english currently. godoc is beautiful look to see documentation.

However all of programmers cannnot write english in the world. As I said in above, // XXX make bytes.Buffer from w often makes confusing in non-english speakers. If possibly, we have better to provide the way to write godoc for non-english people.

In additional, godoc accept to write in free style. So often, I forgot to add description of new parameters. As @ericlagergren said, varidator will be useful to check whether the documentation is broken.

I say again, I don't want to add complying. Just want to add extensible for the documentation. For example, This is one of the way to do.

$ godoc -html -formatter ./path/to/formatter .

There is a hook in the packages that godoc uses that can be used to turn all references to certain names into code font, so that parameters can be shown in a separate font. But it's unclear if that's sufficient for your needs.

We don't want to add explicit markup, like @param and @return, even optionally. It's important that doc comments read as ordinary comments, without needing to know about special syntax.

@rsc this isn't my issue, but I'd appreciate having parameter names be in code.

As noted before, one of the first principles of godoc comments is to avoid markup like @param.