メンテナーの視点から見たハクトーバーフェスト

この度、プロジェクトのメンテナーとして Hacktoberfest に参加することにしました。

このプロジェクトは (AnadiCSV)[https://github.com/Cereal84/AnadiCSV] で、SQL クエリを介して CSV ファイルのデータをクエリするためのシンプルなツールです。

AnadiCSV は Python で書かれ、DuckDB と Textual を使用します。このプロジェクトは初期状態でハックトーバーフェストに提出されました。このアイデアは、次の 2 つの理由からハックトーバーフェストを利用することでした:

• 「外部」貢献者とともにプロジェクトを管理する方法を学びます
• 人々が貢献できるようにコードを改善します。

ここで、これまでに学んだ教訓をいくつか紹介します。

詳しい問題点を書く

あなたにとって問題が非常に明確であっても、外部の貢献者にとっても同じであるとは限りません。特に経験の浅い場合はそうです。

その問題について対話を試みてください

詳細だけでは不十分な場合があります。全員がやるべき作業を確実に理解できるように、対話を開始することをお勧めします。

貢献ファイルは重要です

私はリポジトリ内のこのファイルを常に無視してきました。代わりに、人々の貢献を支援したい場合は、期待する動作方法、従うべきルール、そして場合によってはセクションの背後にあるロジックを記述できます (つまり、コード内で明確ではない場合、関連するすべてのファイルである cli オプションを追加したい場合)。

不十分なコードレビューを行うのは得策ではありません

急いでいるけど、できるだけ早く PR をマージしたい場合があります。 PR をすぐに読んで問題ないと思われる場合は、いくつかのファイルを忘れてしまったため、または変更が非常に簡単で確実に正しいと考えたため、いくつかのファイルをスキップします。
明らかに、リポジトリが壊れます:)。

GitHubアクションは良いです

コード フォーマッタやリンターなどのチェックを追加すると、コード レビュー中にそれらの作業を行わずに済み、重要なことに集中できるようになります。

結論

これまで私は多くのことを学んできました。このプロジェクトを開始できてうれしく思います。そして、誰にでも同じことをやってみるよう提案できます。

ハックトーバーフェストの問題を探している人は、ぜひ遊びに来てください:)。

以上がメンテナーの視点から見たハクトーバーフェストの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。