From 2722b458df1bfdc0dcb9d1f4e7283d6b93925626 Mon Sep 17 00:00:00 2001 From: yossydev Date: Mon, 27 Nov 2023 18:27:57 +0900 Subject: [PATCH 1/3] feat: translate versioning page --- .../content/docs/ja/internals/versioning.mdx | 44 +++++++++++++++++++ 1 file changed, 44 insertions(+) create mode 100644 website/src/content/docs/ja/internals/versioning.mdx diff --git a/website/src/content/docs/ja/internals/versioning.mdx b/website/src/content/docs/ja/internals/versioning.mdx new file mode 100644 index 000000000000..fed8d334fd1c --- /dev/null +++ b/website/src/content/docs/ja/internals/versioning.mdx @@ -0,0 +1,44 @@ +--- +title: バージョニング +description: Biomeのバージョニング方法について +--- + +lint ルールやフォーマットレイアウトなどの修正により、スクリプトが通らなくなる可能性があります。これらの変更の性質上、範囲演算子を使うのではなく、正確なバージョンを package.json に保存することを強く推奨します。 + +この方法によって、スクリプトが予期せず失敗することがなくなります。 + +## セマンティックバージョニング + +Biomeはセマンティックバージョニングに従っている。Biome はツールチェーンという性質上、どのような変更がメジャー、マイナー、パッチとみなされるかが不明確な場合があります。そのため、Biome は以下のバージョンガイドを使用しています： + +### パッチリリース +* 有効なコードに対してlintエラーを発生させるlintルールの修正（偽陽性） +* 不正確なコード提案の修正 +* 無効なコードを生成するか、プログラムのセマンティクスを変更する構文のフォーマット修正 +* ドキュメントの改善 +* Biomeの機能を変更しない内部の変更： + * リファクタリング + * パフォーマンスの改善 + * テストカバレッジの向上や変更 +* 診断の文言の改善や診断のレンダリングの修正 +* リリース失敗後の再リリース +* 確立された構文のフォーマットの変更 + +### マイナーリリース +* 新しいルールの追加、またはデフォルトでは推奨されない既存のlintルールを安定したグループに昇格 +* 最近導入された言語機能のlintとフォーマットのサポートを追加（これによりlintエラーが増える場合もあります） +* 推奨ルールの削除 +* 既存ルールの非推奨化 +* フォーマットを変更したり、lintエラーを増やすことなく、新たな設定オプションを追加 +* 新しい推奨 lint ルールの追加、または既存の lint ルールを nursery グループから stable グループの推奨 lint ルールに昇格 +* 「nursery」以外のルールの削除、またはルールを「nursery」グループに降格 + +### メジャーリリース +* フォーマットが変わったり、lintエラーが増えるような設定の変更（オプションの追加/削除、デフォルト値の変更） +* Biomeの公開APIへの変更 +* 一部のスポットライトを必要とする新機能やツールの昇格 + +## Visual Studio Code 拡張機能 +Visual Studio Codeは、拡張機能について[プレリリースタグをサポートしていません](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#prerelease-extensions)。そのため、Biomeは以下のバージョンスキーマを使用して安定版とプレビュー版を区別します： +* 安定版リリースは偶数のバージョン番号を使用します：10, 12, 14, 16, ... +* プレビュー版は奇数のバージョン番号を使用します：11, 13, 15, 17, ...``` From 890d0bbdfb8271dec424c9d9fcfe7d327878923c Mon Sep 17 00:00:00 2001 From: yossydev Date: Tue, 28 Nov 2023 12:12:53 +0900 Subject: [PATCH 2/3] fix: made the wording more readable. --- .../content/docs/ja/internals/versioning.mdx | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/website/src/content/docs/ja/internals/versioning.mdx b/website/src/content/docs/ja/internals/versioning.mdx index fed8d334fd1c..132d26677842 100644 --- a/website/src/content/docs/ja/internals/versioning.mdx +++ b/website/src/content/docs/ja/internals/versioning.mdx @@ -3,13 +3,13 @@ title: バージョニング description: Biomeのバージョニング方法について --- -lint ルールやフォーマットレイアウトなどの修正により、スクリプトが通らなくなる可能性があります。これらの変更の性質上、範囲演算子を使うのではなく、正確なバージョンを package.json に保存することを強く推奨します。 +lint ルールや format レイアウトなどの修正により、スクリプトが通らなくなる可能性があります。これらの変更の性質上、範囲演算子を使うのではなく、正確なバージョンを package.json に保存することを強く推奨します。 この方法によって、スクリプトが予期せず失敗することがなくなります。 ## セマンティックバージョニング -Biomeはセマンティックバージョニングに従っている。Biome はツールチェーンという性質上、どのような変更がメジャー、マイナー、パッチとみなされるかが不明確な場合があります。そのため、Biome は以下のバージョンガイドを使用しています： +Biome はセマンティックバージョニングに従っています。Biome はツールチェーンという性質上、どのような変更がメジャー、マイナー、パッチとみなされるかが不明確な場合があります。それを解決するために、以下のバージョンガイドを使用しています： ### パッチリリース * 有効なコードに対してlintエラーを発生させるlintルールの修正（偽陽性） @@ -25,18 +25,17 @@ Biomeはセマンティックバージョニングに従っている。Biome は * 確立された構文のフォーマットの変更 ### マイナーリリース -* 新しいルールの追加、またはデフォルトでは推奨されない既存のlintルールを安定したグループに昇格 -* 最近導入された言語機能のlintとフォーマットのサポートを追加（これによりlintエラーが増える場合もあります） +* 最近導入された言語機能の lint と format のサポート追加（これにより lint エラーが増える場合があります） * 推奨ルールの削除 * 既存ルールの非推奨化 -* フォーマットを変更したり、lintエラーを増やすことなく、新たな設定オプションを追加 -* 新しい推奨 lint ルールの追加、または既存の lint ルールを nursery グループから stable グループの推奨 lint ルールに昇格 -* 「nursery」以外のルールの削除、またはルールを「nursery」グループに降格 +* format や lint 結果に影響のない新たな設定オプションの追加 +* 新しい推奨 lint ルールの追加、または既存の lint ルールの nursery グループから stable グループへの昇格 +* nursery 以外の lint ルールの削除、nursery グループへの降格 ### メジャーリリース -* フォーマットが変わったり、lintエラーが増えるような設定の変更（オプションの追加/削除、デフォルト値の変更） -* Biomeの公開APIへの変更 -* 一部のスポットライトを必要とする新機能やツールの昇格 +* format や lint エラーに影響を与える設定オプションの追加/削除・デフォルト値の変更 +* Biome の公開 API の変更 +* 一部の注目を必要とする新機能やツールの昇格 ## Visual Studio Code 拡張機能 Visual Studio Codeは、拡張機能について[プレリリースタグをサポートしていません](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#prerelease-extensions)。そのため、Biomeは以下のバージョンスキーマを使用して安定版とプレビュー版を区別します： From 7f385a07022e0bd1ad4a91fa86a71ee9e661793c Mon Sep 17 00:00:00 2001 From: yossydev Date: Tue, 28 Nov 2023 13:05:23 +0900 Subject: [PATCH 3/3] fix: update versioning documentation --- website/src/content/docs/ja/internals/versioning.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/website/src/content/docs/ja/internals/versioning.mdx b/website/src/content/docs/ja/internals/versioning.mdx index 132d26677842..ddbfecf01ab2 100644 --- a/website/src/content/docs/ja/internals/versioning.mdx +++ b/website/src/content/docs/ja/internals/versioning.mdx @@ -35,7 +35,7 @@ Biome はセマンティックバージョニングに従っています。Biome ### メジャーリリース * format や lint エラーに影響を与える設定オプションの追加/削除・デフォルト値の変更 * Biome の公開 API の変更 -* 一部の注目を必要とする新機能やツールの昇格 +* 特に注目を集めるべき新機能やツールの昇格 ## Visual Studio Code 拡張機能 Visual Studio Codeは、拡張機能について[プレリリースタグをサポートしていません](https://code.visualstudio.com/api/working-with-extensions/publishing-extension#prerelease-extensions)。そのため、Biomeは以下のバージョンスキーマを使用して安定版とプレビュー版を区別します：