0
0
mirror of https://github.com/conventional-commits/conventionalcommits.org.git synced 2025-08-22 22:08:35 +00:00

fix: translation overlook and broken markdown fixed

This commit is contained in:
M.Sakamaki 2019-05-10 21:25:14 +09:00 committed by Damiano Petrungaro
parent 83d60994f8
commit 06094b679f

View File

@ -41,7 +41,7 @@ Conventional Commitsの仕様は、コミットメッセージのための軽量
コミットにはあなたのライブラリの利用者に思想を伝えるために、次の構造要素を持ちます: コミットにはあなたのライブラリの利用者に思想を伝えるために、次の構造要素を持ちます:
1. **fix:** _型_ `fix` はコードベースのバグにパッチを当てる場合です。(これは セマンティックバージョン管理における[`PATCH`](http://semver.org/#summary) in semantic versioning)に相当します) 1. **fix:** _型_ `fix` はコードベースのバグにパッチを当てる場合です。(これは セマンティックバージョン管理における[`PATCH`](http://semver.org/#summary)に相当します)
1. **feat:** _型_ `feat` はコードベースに新しい機能を追加した場合です。(これはセマンティックバージョン管理における [`MINOR`](http://semver.org/#summary)に相当します) 1. **feat:** _型_ `feat` はコードベースに新しい機能を追加した場合です。(これはセマンティックバージョン管理における [`MINOR`](http://semver.org/#summary)に相当します)
1. **BREAKING CHANGE:** 本体または脚注の冒頭に `BREAKING CHANGE:` という内容があるコミットは、APIの重大な変更を意味できます。(セマンティックバージョン管理における[`MAJOR`](http://semver.org/#summary)に相当します) 1. **BREAKING CHANGE:** 本体または脚注の冒頭に `BREAKING CHANGE:` という内容があるコミットは、APIの重大な変更を意味できます。(セマンティックバージョン管理における[`MAJOR`](http://semver.org/#summary)に相当します)
`BREAKING CHANGE` はあらゆる _型_ のコミットに含めることができます。 `BREAKING CHANGE` はあらゆる _型_ のコミットに含めることができます。
@ -102,27 +102,27 @@ closes issue #12
この文書における次の各キーワード「しなければならない( MUST )」、 「してはならない( MUST NOT )」、「要求されている( REQUIRED )」、 「することになる( SHALL )」、「することはない( SHALL NOT )」、 「する必要がある( SHOULD )」、「しないほうがよい( SHOULD NOT )」、 「推奨される( RECOMMENDED )」、「してもよい( MAY )」、 「選択できる( OPTIONAL )」は、 [RFC 2119 (IPA 日本語)](https://www.ipa.go.jp/security/rfc/RFC2119JA.html) で述べられているように 解釈されるべきものです。 この文書における次の各キーワード「しなければならない( MUST )」、 「してはならない( MUST NOT )」、「要求されている( REQUIRED )」、 「することになる( SHALL )」、「することはない( SHALL NOT )」、 「する必要がある( SHOULD )」、「しないほうがよい( SHOULD NOT )」、 「推奨される( RECOMMENDED )」、「してもよい( MAY )」、 「選択できる( OPTIONAL )」は、 [RFC 2119 (IPA 日本語)](https://www.ipa.go.jp/security/rfc/RFC2119JA.html) で述べられているように 解釈されるべきものです。
1. コミットは_型_から始まり、次に選択できる OPTIONAL _範囲_と、末尾に要求されている REQUIRED )コロンとスペースで成り立ちます。 1. コミットは _型_ から始まり、次に選択できる( OPTIONAL _範囲_ と、末尾に要求されている( REQUIRED )コロンとスペースで成り立ちます。
1. コミットがあなたのアプリケーションやライブラリに新しい機能を追加するとき、 _型_は`feat`にしなければならない( MUST )。 1. コミットがあなたのアプリケーションやライブラリに新しい機能を追加するとき、 _型_ は`feat`にしなければならない( MUST )。
1. コミットがあなたのアプリケーションのためのバグ修正を表すとき、_型_は `fix`にしなければならない( MUST )。 1. コミットがあなたのアプリケーションのためのバグ修正を表すとき、 _型_ `fix`にしなければならない( MUST )。
1. _範囲_は_型_の後に記述してもよい MAY )。 _範囲_は括弧で囲まれたコードベースのセクションを記述する名詞にしなければならない MUST )。例: `fix(構文解析ツール): ' 1. _範囲_ _型_ の後に記述してもよい( MAY )。 _範囲_ は括弧で囲まれたコードベースのセクションを記述する名詞にしなければならない( MUST )。例: `fix(構文解析ツール): '
1. _説明_ は型/範囲の直後にしなければならない( MUST )。 1. _説明_ は型/範囲の直後にしなければならない( MUST )。
_説明_はコード変更の要約です。 _fix文字列に複数の空白がある場合の配列解析における問題_ _説明_ はコード変更の要約です。 _fix文字列に複数の空白がある場合の配列解析における問題_
1. 短い_説明_の後に、より長いコミットの本文を追加してもよく MAY )、コード変更に関する追加の情報を提供することができます。 1. 短い _説明_ の後に、より長いコミットの本文を追加してもよく( MAY )、コード変更に関する追加の情報を提供することができます。
本文は、_説明_の下に1行の空行を追加しなければならない MUST )。 本文は、_説明_ の下に1行の空行を追加しなければならない MUST )。
1. 1行以上の_脚注_は、本文の後ろに1行の空白行を入れてもよい MAY 。_脚注_はコミットに関するメタ情報、例えば関連するプルリクエスト、レビュアー、変更の中断などを1行につき1つのメタ情報として含めなければならない MUST )。 1. 1行以上の _脚注_ は、本文の後ろに1行の空白行を入れてもよい MAY )。 _脚注_ はコミットに関するメタ情報、例えば関連するプルリクエスト、レビュアー、変更の中断などを1行につき1つのメタ情報として含めなければならない MUST )。
1. 重大な変更(`BREAKING CHANGE`)は、本文セクションの一番最初、または脚注の先頭にしなければいけません( MUST )。 1. 重大な変更(`BREAKING CHANGE`)は、本文セクションの一番最初、または脚注の先頭にしなければいけません( MUST )。
重大な変更は大文字のテキスト `BREAKING CHANGE` と続くコロンとスペースから構成されなければいけません( MUST )。 重大な変更は大文字のテキスト `BREAKING CHANGE` と続くコロンとスペースから構成されなければいけません( MUST )。
1. APIについて何が変わったのかを説明する`BREAKING CHANGE:`の後には説明を描かなければいけません( MUST )。 1. APIについて何が変わったのかを説明する`BREAKING CHANGE:`の後には説明を描かなければいけません( MUST )。
例、 _BREAKING CHANGE: 環境変数が設定ファイルよりも優先されるようになりました。_ 例、 _BREAKING CHANGE: 環境変数が設定ファイルよりも優先されるようになりました。_
1. `feat`と`fix` 以外の_型_をあなたのコミットメッセージに仕様してもよい MAY )。 1. `feat`と`fix` 以外の _型_ をあなたのコミットメッセージに仕様してもよい( MAY )。
1. Conventional Commitsを構成する情報の単位は、必ず大文字の`BREAKING CHANGE`を除いて、実装側は大文字と小文字を別の物して扱ってはいけない( MUST NOT 1. Conventional Commitsを構成する情報の単位は、必ず大文字の`BREAKING CHANGE`を除いて、実装側は大文字と小文字を別の物して扱ってはいけない( MUST NOT
1. さらに重大な変更の注意を引くために、_種類_/_範囲_の `:` の前に `!`を追加することができます( MAY )。`BREAKING CHANGE: description`は、接頭辞の`!`とともに、本文または脚注にも含めなければなりません( MUST )。 1. さらに重大な変更の注意を引くために、 _種類_ / _範囲_ `:` の前に `!`を追加することができます( MAY )。`BREAKING CHANGE: description`は、接頭辞の`!`とともに、本文または脚注にも含めなければなりません( MUST )。
## 何故 Conventional Commits を使うのか ## 何故 Conventional Commits を使うのか
* 変更履歴(CHANGELOG)を自動的に生成できます。 * 変更履歴(CHANGELOG)を自動的に生成できます。
* semantic version単位で自動的に履歴を纏めれますコミットされた_型_に基づきます * semantic version単位で自動的に履歴を纏めれますコミットされた _型_ に基づきます)。
* チームメイトや一般のユーザー、およびその他の利害関係者へ変更の内容を伝えることができる。 * チームメイトや一般のユーザー、およびその他の利害関係者へ変更の内容を伝えることができる。
* ビルドおよび公開プロセスをトリガーにできます。 * ビルドおよび公開プロセスをトリガーにできます。
* より構造化されたコミット履歴を調査できるようにすることで、人々があなたのプロジェクトに貢献しやすくなります。 * より構造化されたコミット履歴を調査できるようにすることで、人々があなたのプロジェクトに貢献しやすくなります。
@ -139,7 +139,7 @@ _説明_はコード変更の要約です。 _fix文字列に複数の空白
どちらでも問題はありません、一貫性を保つことが最善です。 どちらでも問題はありません、一貫性を保つことが最善です。
### コミットが複数のコミットタイプ(_型_)に準拠している場合はどうすればいいですか? ### コミットが複数のコミットタイプ( _型_ )に準拠している場合はどうすればいいですか?
可能な限り前に戻り複数のコミットに分割します。 可能な限り前に戻り複数のコミットに分割します。
Conventional Commits の利点の一つは、より組織化されたコミットとプルリクエストを行う事を可能にする事です。 Conventional Commits の利点の一つは、より組織化されたコミットとプルリクエストを行う事を可能にする事です。
@ -149,14 +149,14 @@ Conventional Commits の利点の一つは、より組織化されたコミッ
無秩序にただ早く開発することはお勧めではありません。 無秩序にただ早く開発することはお勧めではありません。
それはあなたがさまざまな貢献者との複数のプロジェクト間で長期的に素早く動けるようにするのを助けます。 それはあなたがさまざまな貢献者との複数のプロジェクト間で長期的に素早く動けるようにするのを助けます。
### Conventional Commitsで開発者は提供された_型_を検討することになるため、コミットの_型_を制限することができますか ### Conventional Commitsで開発者は提供された _型_ を検討することになるため、コミットの _型_ を制限することができますか?
Conventional Commitsは、修正などの特定の_型_のコミットメントを行うように促します。 Conventional Commitsは、修正などの特定の _型_ のコミットメントを行うように促します。
それ以外の点では、Conventional Commitsの柔軟性により、あなたのチームは彼ら自身の_型_を新しく作り、時間の経過とともにそれらの_型_を変更することもできます。 それ以外の点では、Conventional Commitsの柔軟性により、あなたのチームは彼ら自身の _型_ を新しく作り、時間の経過とともにそれらの _型_ を変更することもできます。
### これはSemVerとどのような関係を持っていますか ### これはSemVerとどのような関係を持っていますか
`fix` _型_のコミットは`PATCH`リリースへ変換します。 `feat`_型_のコミットは`MINOR`リリースに変換します。 _型_にかかわらずコミット内で `BREAKING CHANGE`を使ったコミットは`MAJOR`リリースに変換するべきでしょう。 `fix` _型_ のコミットは`PATCH`リリースへ変換します。 `feat` _型_ のコミットは`MINOR`リリースに変換します。 _型_ にかかわらずコミット内で `BREAKING CHANGE`を使ったコミットは`MAJOR`リリースに変換するべきでしょう。
### 私の拡張仕様をどのようにしてConventional Commitsの仕様にバージョンアップするべきでしょうか、例 `@jameswomack/conventional-commit-spec` ### 私の拡張仕様をどのようにしてConventional Commitsの仕様にバージョンアップするべきでしょうか、例 `@jameswomack/conventional-commit-spec`
@ -164,12 +164,12 @@ SemVerを使用して、この仕様に対する独自の拡張仕様をリリ
### 間違ったコミットタイプを使用してしまった時はどうしたらいいですか? ### 間違ったコミットタイプを使用してしまった時はどうしたらいいですか?
#### 仕様的に正しい型だが意味を間違っえた_型_を使用した場合、例えば `feat`の代わりに`fix` #### 仕様的に正しい型だが意味を間違っえた _型_ を使用した場合、例えば `feat`の代わりに`fix`
間違いをマージやリリースする前に、コミット履歴を編集する`git rebase -i`を使うことを勧めます。 間違いをマージやリリースする前に、コミット履歴を編集する`git rebase -i`を使うことを勧めます。
リリース後、どのツールやプロセスを使用するかによってクリーンアップは異なってくるでしょう。 リリース後、どのツールやプロセスを使用するかによってクリーンアップは異なってくるでしょう。
#### 仕様に*ない*_型_を使った時、例えば`feet` ではなく`feat` #### 仕様に *ない* _型_ を使った時、例えば`feet` ではなく`feat`
最悪のシナリオはコミットが conventional commit の仕様を満たさない場合です、しかしそれは世界の終わりではありません。 最悪のシナリオはコミットが conventional commit の仕様を満たさない場合です、しかしそれは世界の終わりではありません。
それは単に仕様に基づいているツールによってコミットが見逃されるだけでしかありません。 それは単に仕様に基づいているツールによってコミットが見逃されるだけでしかありません。