go mod init <ここには何を書く？>

Question

質問したいことはタイトルのとおりです．

Go Modulesの使い方を勉強していて，go mod init <???>を実行するとgo.modができて，initのあとに入力した文字列がgo.modの先頭にmodule <???>となるのはわかったのですが，

あるQiitaの記事ではgo mod init sample

Hugoのgo.modではmodule github.com/gohugoio/hugo

Kubernetesのgo.modではmodule k8s.io/kubernetes

Echoのgo.modではmodule github.com/labstack/echo/v4

となっていました．
GitHubでいくつかのリポジトリをみた感じでは，Hugoと同一のパターンが多かったのですが，結局そこには何を書いていて，何を書くのが良いのでしょうか？

Answer 1

書くべきなのは「importpath」です。
importpathの定義はgo help importpathを参照してください。

go mod init hoge.org/moge/foobar

とした場合、hoge.org/moge/foobarでアクセス可能なリポジトリ（gitかmercurialかsubversionかbazaar）に置かれる予定（必須ではない）という扱いになります。
「hoge.org」はリポジトリホストのドメイン名です。

go.modファイルのある配下の*.goファイルから
import "hoge.org/moge/foobar"にてそのモジュールを利用可能になります。

foobarがmainパッケージの場合ビルドすると「foobar」というバイナリが出力されます。

「importpath」の理想は世界で一意（ユニーク）なものですが、必須条件ではありません。

github.comにリポジトリを置く場合はほとんどの場合自然にユニークになる。
「github.com/個人IDor団体ID/リポジトリ名」になるし、GitHubの新規リポジトリ作成で同盟のリポジトリは作れないからです。

一般的な用途ではリポジトリルートのURLを「importpath」としてgo mod initの引数に使うのが良いでしょう。

go mod init sampleについてはリポジトリと紐づけない一時的なものとして利用することはできます。こうして作られたモジュールは公開する条件を満たせないので例えリポジトリに置いて公開しても第三者がgo-getすることはできないモジュールになります。もちろんこの形での公開は推奨はされません。（手元で書き捨てる用途とか学習用途とお考え下さい）