godoc package documentation file doc.go file doesn't exist

[wallclockbuilder]

The package wide docs are currently located in the chop.go file. Thats inappropriate to put package-wide documentation in a specific module file. It should much more appropriately be located in the file docs.go

[wallclockbuilder]

Please move the package specific documentation to docs.go.

[wallclockbuilder]

Please cite a link that supports the convention that package specific files should be located in the doc.go file. That would be helpful and educational to us all. Otherwise your suggestions remain what they are, personal preferred suggestions. Thanks.

[wallclockbuilder]

Here's the documentation for documenting go packages:

[wallclockbuilder]

Heres the brief version as used by the sort package:

[wallclockbuilder]

And heres the detailed version as used by the gob package: beginning ending

[wallclockbuilder]

So doc.go file please.

[wallclockbuilder]

:+1: