golang-standards/project-layout

golang-standards/project-layout とは Go プロジェクトの基本的なディレクトリ構成を定義したものです。
Go 公式で定義しているものではありません。

リポジトリの解説

ディレクトリの説明はルートの README に記載があります。
README は多数の言語に対応しており、日本語も対応しているようです。

日本語の README:

また、各ディレクトリにも README が存在しており、例が記載されていることもあります。

OpenAPI 定義などを置くディレクトリ。

画像などを置くディレクトリ。

Go における main 関数を置くディレクトリ。
このディレクトリに置いた main 関数から /internal や /pkg にアクセスします。

設定を管理するディレクトリ。

デプロイメント設定を置くディレクトリ。

設計などドキュメントを置くディレクトリ。

ライブラリとしてリポジトリを公開した際にライブラリの利用例を置いておくようです。

Git のフックを置くディレクトリ。

システム init を置くディレクトリ。

Go 1.4 から言語仕様上、特別なパッケージなようです。

ライブラリコードを置くディレクトリ。

スクリプトを置くディレクトリ。
プロジェクトルートに存在する Makefile からこのディレクトリに置いてあるスクリプトを呼び出すことで Makefile をシンプルにすることができます。

テストコードやテストに使用するデータを置くディレクトリ。

サードパーティのコードを置くディレクトリ。

Go プロジェクトをサポートするツールを置くディレクトリ。

依存関係を管理するディレクトリ。
go mod vendor を実行するとこのディレクトリが作成されます。

Web アプリケーションに関するコードを置くディレクトリ。

Web サイトのデータを置くディレクトリ。