umyuu commited on
Commit
9e9d707
1 Parent(s): a5d9d1b

コントリビューターガイドラインを加筆しました。

Browse files

概要、リポジトリ構成、バグ報告方法、コーディング規約の欄を追記しました。

Files changed (1) hide show
  1. docs/CONTRIBUTING.md +38 -1
docs/CONTRIBUTING.md CHANGED
@@ -1,5 +1,42 @@
1
- ## プルリクエストについて
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
2
  - プルリクエストの派生元ブランチ
3
  main ブランチから派生させてプルリクエストを作成してください。
4
  - プルリクエストのライセンス:
5
  プルリクエストを送信することで、あなたの貢献がリポジトリと同じMITライセンスに従うこと、そしてあなたの貢献が将来的にプロジェクトのライセンス変更に含まれる可能性があることに**ご理解とご協力**をお願いします。
 
 
 
 
 
 
 
 
 
 
1
+ # Contributing Guide
2
+ ## 🎉 ようこそ!
3
+ このプロジェクトへの関心と貢献に感謝します!あなたの貢献は、このプロジェクトを改善し、コミュニティを成長させるのに大いに役立ちます。このガイドは、プロジェクトへの貢献をスムーズに進めるためのものです。
4
+
5
+ ## 📚 概要
6
+ このガイドでは、リポジトリの構成、プルリクエストの作成方法、バグ報告の方法、およびコーディング規約について説明します。これらのガイドラインを理解し、遵守することで、あなたの貢献がプロジェクトにとって最大の価値を持つことができます。
7
+
8
+ ## 🧱 リポジトリ構成
9
+ - 📂`/src`: Pythonソースコード。
10
+ 主要な機能のコードが含まれています。
11
+ - 🧪`/test`: Pythonの単体テストコード。
12
+ 各機能の正確さを確認するためのテストスクリプトが含まれています。
13
+ - 📜`/scripts`: 実行用スクリプト。
14
+ Jupyter NotebookとGradioの自動再読み込みスクリプトが含まれており、これらはアプリの実行とデバッグを容易にします。
15
+ - 🎨`/assets`: サンプル画像。
16
+ 視覚的な要素を提供します。
17
+ - 📚`/docs`: ドキュメンテーション。
18
+ - `./CONTRIBUTING.md`: これは現在ご覧になっているドキュメントで、プロジェクトへの貢献方法について詳しく説明しています。新しいコントリビューターはここから始めることをお勧めします。
19
+ - `./ThirdPartyNotices.txt`:参考情報としてこのプロジェクトで使用している外部ライブラリのライセンス情報が記載されています。
20
+ - 📚`/.github`: GitHubの設定ファイルが格納されています。
21
+ - `/.github\ISSUE_TEMPLATE`: issueを作成する際のテンプレートが含まれています。これらのテンプレートは、issueを作成する際のフォーマットを提供し、必要な情報を整理するのに役立ちます。
22
+ - `/.github\workflows`: GitHub Actionsのワークフロー設定。
23
+ - `./codeql.yml`:コードのセキュリティ問題を自動的に検出します。
24
+ - `./deploy.yml`:プロジェクトのデプロイを自動化します。
25
+ - `./python-app.yml`:アプリケーションのコンパイルとflake8のコードチェックとテストコードを実行します。
26
+ - 📚`/.vscode`: vscodeの設定
27
+ アプリケーションの開発に適したVSCodeの設定情報が含まれています。これには、推奨される拡張機能、コードフォーマットの設定などが含まれています。
28
+
29
+ ## 🔀 プルリクエストについて
30
  - プルリクエストの派生元ブランチ
31
  main ブランチから派生させてプルリクエストを作成してください。
32
  - プルリクエストのライセンス:
33
  プルリクエストを送信することで、あなたの貢献がリポジトリと同じMITライセンスに従うこと、そしてあなたの貢献が将来的にプロジェクトのライセンス変更に含まれる可能性があることに**ご理解とご協力**をお願いします。
34
+
35
+ ## 🐛 バグ報告
36
+ バグを見つけた場合は、まず[既存のissue](../issues)を確認してください。
37
+ 同じバグについてのissueが存在しない場合は、[新しいバグ報告](../issues/new?assignees=&labels=bug&projects=&template=10-problem.yaml)を作成してください。
38
+
39
+ ## 📝 コーディング規約
40
+ - コードスタイル: このプロジェクトではPEP8に準拠し、コードチェックツールとしてflake8を採用しています。VSCodeを使用し開発すると拡張機能がレコメンドされます。拡張機能を導入して確認してください。
41
+ - 変数名: 変数名は明確で意味のある名前を使用してください。ローカル変数以外では一文字の変数名は避け、名前から変数の目的が理解できるようにしてください。
42
+ - ドキュメンテーション: 公開されるすべての関数やクラス、メソッドにはDocstringを追加してください。これにより、他の開発者がコードの目的と動作を理解しやすくなります。