その他

プロジェクトの見方 (応用)

少し応用的な内容です。これを知っていたら、他の人が作ったプロジェクトの読み取りが楽になるかもしれないです。

一般的なフォルダー・ファイル

よく使うフォルダー・ファイルとして、以下のものが挙げられます。(特に重要なファイルを太字で示しています)

フォルダー・ファイル用途
.github/GitHub 関係のファイルを格納しています。
.github/copilot-instructions.mdAI に質問する際に、AI に知っておいてほしい情報を入れます。
コードを書く際のルール (インデントや改行ルール、コメント記載など)
.github/workflows/GitHub での自動化関係です。CI/CD と言われています。
docs/開発で用いる資料や過去のバージョンの変更資料などを格納しています。
src/プログラム本体 (ソース) を入れています。
tests/プログラムのテストを入れるフォルダーです。
.editorconfigエディターの設定をするファイルです。エディター側が自動認識していい感じにしてくれるので、特に気にしなくていいです。
.gitattributesGit のファイル扱いに関するファイルです。Git 側が認識するので、特に気にしなくていいです。
.gitignoreGit で Commit を無視するファイルの設定です。アップロードしたくないファイル (機密情報ファイルや、自分用のメモ) などを設定できます。気にしなくてもいいです。
LICENSEプログラムのライセンスファイルです。プログラムを見るだけの際は、特に気にしなくていいです。
プログラムを完全に流用する場合、派生プログラムを作成したい場合などはライセンスに注意する必要があります。(本資料では割愛します)
README.md最も重要な資料です。プログラムの概要、目的、使い方、配布などの情報を網羅しています。