貢献について

cssnanoへの貢献ありがとうございます!大小に関わらず、あらゆる貢献に感謝いたします。cssnanoに貢献された方は、CONTRIBUTORS.mdにある貢献者リストに自身を追加することをお勧めします。

cssnanoのコードにどのように貢献できますか?

バージョン4以降、モノレポで開発しています。これは、多くの変換が互いに重複しているため、まとめてテストするのが容易になるためです。それ以外に、Node.js、pnpm、およびgitがインストールされている必要があります。次に、これらのコマンドを実行してリポジトリをセットアップできます。

git clone git@github.com:cssnano/cssnano.git
cd cssnano
pnpm install

テストは以下のように実行できます。

pnpm test

help wantedタグが付いたものを課題トラッカーで確認することをお勧めします。これは、作業に取り組み、コードを記述するための最初のステップです。他にあなたが対処できると考える未解決の課題があれば、関心を表明するコメントをスレッドに投稿してください。

課題トラッキングされていない機能のアイデアがある場合は、プルリクエストを作成する前に、課題を開いてください。コードを書く前に要件について話し合う方が、より有益だと考えています。

変更ログを生成するために役立てるため、コミットメッセージにはconventional commits形式に従ってください。

ドキュメント

ドキュメントウェブサイトも、/site下にリポジトリに含まれています。docusaurusを実行し、依存関係をダウンロードするために別のpnpm installが必要です。その後、pnpm startを実行して、ローカルでドキュメントを参照できます。

ドキュメントの一部は自動的に生成されるため、手動で編集しないでください。

リリース

変更ログとタグリリースの更新には@changesets/cliを使用します。まず、公開するすべての変更に対して変更セットが存在することを確認してください。変更セットは、変更の説明と影響を受けるパッケージを含むテキストファイルです。変更セットを作成するには、以下を実行します。

pnpm changeset

ツールが自動的に依存関係を検出するのではなく、手動で影響を受けるパッケージを選択することをお勧めします。たとえば、変更がプラグインcssnano-preset-defaultに影響を与える場合、プラグインとcssnano-preset-defaultを手動で選択します(他の依存関係のあるプリセットも同様です)。リリースにタグを付け、変更ログを生成するには、以下を実行します。

pnpm changeset version

npmにリリースを公開するには、以下を実行します。

pnpm all-publish

package.jsonスクリプトを使用しない場合は、最初にパッケージを再構築することを忘れないでください!

  1. pnpm prepare
  2. pnpm changeset publish

他に貢献する方法がありますか?

もちろん!以下のいずれかの分野を試してみてください。

ドキュメントの改善

スペルチェック、明確化、追加のコード例が必要である、または何らかの方法で改善できると思われるドキュメントがあれば、問題の詳細を記述した課題を開いてください。

関連する課題を見つけるには、documentationラベルを使用してください。

課題の改善

課題はプロジェクトを文書化する二次的な手段であり、再現手順が不足している課題がある場合は、元の作成者と連携して、その問題に関する詳細情報を調べることでお手伝いください。

エラーの原因が判明したら、プルリクエストとして失敗するテストケースを送信することで、さらに役立ちます。私たちの多くのテストは、単純なfixtureexpected文字列の比較パターンに従います。

課題へのフィードバックの送信

課題へのフィードバックは非常に重要であり、cssnanoの方向性を決定します。重要な課題、特にquestionラベルが付いた課題について、建設的な批判を投稿してください。

「+1」コメントはあまり役に立たないと考えています。代わりに、GitHubリアクションを使用し、スレッドを購読して進行状況を通知してください。これにより、議論が当該トピックに集中するのに役立ちます。

プルリクエストのレビュー

今後の機能と修正について、より多くの目を通して確認することが非常に重要です。プルリクエストのレビューにご協力ください。いいねリアクションを残すだけでも、何もせずにいるよりも役立ちます。レビューを手伝うことで、バグのあるリリースがカットされた場合、私たち全員の時間無駄を減らすことができます。

私たちと話し合おう!

質問や機能について話し合えるオンラインチャットがあります。チャットに参加し、コミュニティが持つ可能性のある質問に答えてください。ご自身の質問も遠慮なくどうぞ!

サポート方法

プロジェクトに直接貢献する時間がない場合でも、リポジトリにスターを付けるか、Twitterでフォローすることで、私たちを支援できます。口コミは本当に大きな意味があります!

また、経済的に支援することもできます。

最終更新日:2024年6月5日(水)10:27:34 GMT