Skip to content

Commit

Permalink
Merge pull request semver#127 from seratch/patch-1
Browse files Browse the repository at this point in the history
Fix Japanese wording consistency and typo
  • Loading branch information
haacked committed Jan 21, 2016
2 parents 88271c8 + 6f07fa9 commit 5ab0da1
Showing 1 changed file with 2 additions and 2 deletions.
4 changes: 2 additions & 2 deletions lang/ja/spec/v2.0.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,13 +100,13 @@ FAQ

### もしうっかりパブリックAPIをセマンティック バージョニングに対応していない形で変更したらどうなるでしょうか?(例:パッチリリースで主要なバグが発生した場合)

最善の判断をしてください。もしパブリックAPIの動作が変わることで大いに影響するユーザーがいる場合、厳密にはパッチリリースであると考慮されるかもしれんが、その後にメジャーバージョンをリリースするのがベストかもしれません。セマンティック バージョニングはバージョンがどのように変更されるのかということを伝えるためのものであるということを注意して下さい。
最善の判断をしてください。もしパブリックAPIの動作が変わることで大いに影響するユーザーがいる場合、厳密にはパッチリリースであると考慮されるかもしれませんが、その後にメジャーバージョンをリリースするのがベストかもしれません。セマンティック バージョニングはバージョンがどのように変更されるのかということを伝えるためのものであるということを注意して下さい。

### どのように非推奨機能を扱えばよいでしょうか?

既存機能を廃止予定にするのはソフトウェア開発においては普通の事であり、開発を進める上で頻繁に必要となります。パブリックAPIの一部を非推奨にしたい場合、2つのことをすべきです。第一にユーザーに知らせるためにドキュメントを更新して下さい。次に非推奨機能を残したまま新しいマイナーバージョンをリリースして下さい。完全に非推奨機能を削除しメジャーバージョンをリリースする前に、ユーザーがスムーズに新しいAPIに移行できるように少なくとも1回のマイナーバージョン(非推奨機能を含んだ)をリリースして下さい。

### semvarのバージョン文字列に限度はありますか
### semverのバージョン文字列に限度はありますか

いいえ、ありませんが良識ある判断をしてください。例えば255文字数のバージョン文字列は過剰と言えるでしょうし、特定のシステムではそれ独自の文字列の限界値があることでしょう。

Expand Down

0 comments on commit 5ab0da1

Please sign in to comment.