Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

コントリビューション時のガイドをまとめたCONTRIBUTING.md作成の提案 #109

Open
wakame1367 opened this issue Jul 12, 2023 · 1 comment
Assignees
Labels
documentation Improvements or additions to documentation enhancement New feature or request

Comments

@wakame1367
Copy link
Collaborator

wakame1367 commented Jul 12, 2023

このリポジトリへのPRやIssue、例えばバグ報告の際にどのようなフォーマットで報告してほしいか、バグを見つけてPRを出すときにどのようにテスト環境を構築すればよいかなどを明記したCONTRIBUTING.mdを書いたほうがよいと思いました。

書く内容以下のような項目かと思いました。

  • 環境設定: 新しい貢献者が開発環境を設定する方法についてのガイド。依存関係のインストール、ローカルでのプロジェクトのセットアップ、テストの実行方法など。
  • バグ報告: バグを発見した場合の報告方法。具体的な再現手順、期待する結果、実際の結果などを含む詳細な報告が役立つことを示すこと。
  • 新機能の提案: 新しい機能や改善を提案する方法。具体的なユースケースと提案の詳細を提供することが重要であることを強調すること。
  • Pullリクエストの提出: 既存の問題を解決するためのPRを作成し、提出する方法。PRを提出する前に全てのテストが通ることを確認すること、変更の詳細な説明を提供することなど。
  • コードスタイル: 遵守すべきコーディング規約やスタイルガイドがある場合は、その詳細。
  • コミュニティガイドライン: プロジェクトの参加者が遵守すべき行動規範など。

リポジトリコントリビューターのためのガイドラインを定める

@wakame1367 wakame1367 changed the title コントリビューション時のガイドをまとめたCONTRIBUTING.mdの作成の提案 コントリビューション時のガイドをまとめたCONTRIBUTING.md作成の提案 Jul 12, 2023
@wakame1367 wakame1367 self-assigned this Jul 12, 2023
@wakame1367 wakame1367 added documentation Improvements or additions to documentation enhancement New feature or request labels Jul 12, 2023
@nyanp
Copy link
Owner

nyanp commented Jul 13, 2023

@wakame1367
提案ありがとうございます!現状コミュニティが大きいわけでも無いので、まずは参加(特にPR)のハードルを下げるために必要な最小限のところから書いていくと良さそうです。その観点では、

  • 環境設定
  • Pullリクエストの提出

あたりが比較的優先度が高いのかな、と思いました。

コードスタイルについては、現状のnyaggle自身が綺麗な状態ではないので、mypy/flake8/black(あるいはpysen)をまずレポジトリ全体に適用した上で、ツールで担保する方向にもって良ければよいかなーと思っています。-> #110 を立てました。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation enhancement New feature or request
Projects
None yet
Development

No branches or pull requests

2 participants