CONTRIBUTING.md

貢献

以下のルールに従い、気軽に参加してください。

変更がルールに沿っていなかった場合はこちらで編集します。

翻訳の追加方法

大きな範囲の翻訳はプルリクエストを立ててください。

Typo修正や数段落程度の翻訳、変更はissueを使用してください。

コミットメッセージ

コミットメッセージは日本語を使用してください。

コードブロック内は翻訳しません

行數を変更しないでください

翻訳は翻訳元と同じ行に収めてください。

改行の追加は禁止です。

基本的な表記

全角記号、全角数字、半角カタカナの仕様は禁止です。

但し、 〜 は議論する価値があります。

但し、原文で使われていた場合はそのまま使用してください。

セリフ、会話文となっていた場合は 「」 で囲んでください。 鉤括弧の前後はスペースを追加します。

友達は 「 Hono があるよ!」 と言いました。

文章中に英単語を含める場合は、前後にスペースを追加してください。

In this way, Hono is a great framework.

この様に、 Hono は素晴らしいフレームワークです。

インラインコードブロックとダブルクオーテーションは例外です。

"RegExpRouter"

インラインコードブロックの前後にはスペースを追加してください。

句読点の扱い

句点には 。 読点には 、 を使用します。

句点の後にはスペースを追加してください。

但し、改行を入れた場合はスペースが自動で追加されます。

Hono は速い。 また、 Hono は楽しい。

Hono は速い。 また、 Hono は楽しい。

但し、スペースを連続して追加する必要がある場合(英語やインラインコードブロック等)はひとつのスペースにしてください。

Hono は様々なプロフェッショナルが関わっています。 Hono は多くの不可能を可能にしてきました。

文章中で使われる括弧 () の前後にはスペースを入れます

人生 (結婚は除く)

以下の言葉は翻訳しません。

• Hono
• Hono Stack
• Cloudflare Workers
• Fastly Compute
• Deno
• Bun
• Vercel
• Netlify
• AWS Lambda
• Lambda@Edge
• Node.js
• JavaScript
• TypeScript
• etc...

表記ゆれについて

以下の表に従ってください。

原語	日本語訳	備考
proxy	プロキシ
Type-Safe(ty)	型安全
MIME type(s)	MIME タイプ
Web Standard(s)	Web 標準	一部例外

原則的に単語の末尾に長音記号を付けません。

パラメータ

但し、以下のリストは例外です。

• エラー
• ルーター
• サーバー
• ヘルパー
• スターター
• イノベーター
• バリデーター
• イベントリスナー
• サードパーティー

上流の変更

honojs/websiteに変更があった場合は以下のルールに従って取り込みます。

1. ファイルや章の追加だった場合 新しいファイルをそのまま追加し、目次も翻訳せずに追加します。

2. 大きな変更の場合 変更で元データを上書きします。

3. 小さな変更の場合 同期時に翻訳済みのデータを統合します