Suggest Removing Installation Instructions for godoc in Favor of doc Instructions

[MeirSedlis]

Hello World contains instructions for installing godocs but the doc (reference) command works very similarly and is a faster and more lightweight command which may be better suited for learners.

I would be happy to create a PR for this if you agree that doc is a more appropriate command for this section.

[quii]

Go for it!

[Battlesheepu]

Since this was never updated and godoc is now deprecated (as I also mentioned in #653 )

The package is now replaced by pkgsite. Should we go for that replacement instead of doc? Reason being pkgsite having very similar functionality to the deprecated godoc (namely, serving docs locally on a http server).

[quii]

Please do!

[Battlesheepu]

@quii

Sorry for the vagueness in the now-deleted previous comment, which I've noticed only after re-reading it. Let me try again.

It seems that pkgsite doesn't play nice with modules without a '.' in their name, as these are treated as std libraries, which, for me and for the related issue's creator, simply breaks the generated docs. I've found out about this only after generating the docs for myself - which I treat as pkgsite needing a bit more work, since we're being hit with error 424 instead of an explanation in the docs.

I'd like to retract my suggestion of replacing godoc with pkgsite - instead, I propose simply adding a note about godoc being deprecated and replaced by pkgsite, so the situation is clear for the reader. What do you think?

[zacharysyoung]

@Battlesheepu, following your link to the issue about modules without a dot (.), I've reached some different conclusions.

From, golang/go#51368, I found this issue, golang/go#32819, and the discussion there very clearly concludes that modules without a dot are (almost entirely) reserved, and that the documentation needed to be updated; and it was: golang/website@3e18747.

Both of those issues have been closed.

From all that, I conclude that:

• pkgsite will not some day play nice in the way you hope
• learn-go-with-tests might take an opportunity to explain to readers (fresh and seasoned alike) that creating module names without dots (for whatever reason, including brevity for the sake of teaching) comes with risks