質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

新規登録して質問してみよう
ただいま回答率
85.50%
ドキュメント

ドキュメントは、IT用語では、ソフトウェアやハードウェアに関する情報であり、意図された目的、機能性、メインテナンスを含みます。ドキュメントは、多くの様々なフォームとフォーマットに存在しますが、その目的は常に教育することにあります。

Q&A

解決済

2回答

1195閲覧

ソフトウェアの本質的な部分はまったく変えずに、ドキュメント(READMEやヘルプ)を更新したとき、セマンティックバージョニングのバージョンナンバーはどうすべきか

yassh

総合スコア29

ドキュメント

ドキュメントは、IT用語では、ソフトウェアやハードウェアに関する情報であり、意図された目的、機能性、メインテナンスを含みます。ドキュメントは、多くの様々なフォームとフォーマットに存在しますが、その目的は常に教育することにあります。

0グッド

2クリップ

投稿2016/07/27 10:46

現在、1.0.0がリリースされています。今回、READMEとヘルプだけを更新しました。この場合、バージョンナンバーはどうすべきでしょうか。

セマンティックバージョニングには、そのような場合どうすべきかが書かれていなくて、判断に迷っています。

気になる質問をクリップする

クリップした質問は、後からいつでもMYページで確認できます。

またクリップした質問に回答があった際、通知やメールを受け取ることができます。

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

guest

回答2

0

ベストアンサー

1.0.1にバージョンアップする派です。
ソースが一行も変わってなくてもです。

なぜでしょうか?


バージョンアップに対して質問者の方が感じる違和感というのは、
ソフトが変わってないのに、バージョンが上がるからでしょう。

しかし、プログラマ側ではなくユーザ側の視点に立って考えますと、
ヘルプなりのドキュメントがないと、実質的に使えないも同然なのです。

ヘルプに誤記があればバグも同然なのです。
ヘルプを修正するのはバグフィックスと同じなのです。
そして、その修正を認識できなければバグの放置と同じなのです。

よって、バージョンアップ扱いにします。
ただし、ヘルプに別のバージョンを振る方法もあるでしょう。

投稿2016/07/27 12:11

LLman

総合スコア5592

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

yassh

2016/08/01 15:36

ありがとうございました!
guest

0

うちなら
1.0.1
にしますね

ドキュメントの改訂ですが、うちではプログラムのバージョンアップと同じ扱いです

投稿2016/07/27 11:33

dojikko

総合スコア3939

バッドをするには、ログインかつ

こちらの条件を満たす必要があります。

yassh

2016/08/01 15:37

ありがとうございました!
guest

あなたの回答

tips

太字

斜体

打ち消し線

見出し

引用テキストの挿入

コードの挿入

リンクの挿入

リストの挿入

番号リストの挿入

表の挿入

水平線の挿入

プレビュー

15分調べてもわからないことは
teratailで質問しよう!

ただいまの回答率
85.50%

質問をまとめることで
思考を整理して素早く解決

テンプレート機能で
簡単に質問をまとめる

質問する

関連した質問