0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

More than 5 years have passed since last update.

Document > version > Scipy lecture notes > 同じEditionのファイルが更新される > 読者側のバージョン管理

Last updated at Posted at 2018-04-08

関連

ドキュメントの更新

上記の記事に書いたように、Scipy lecture notesには2D arraysの描画コードに間違いがあった。

その間違いが修正されたとissueへのコメントが入った。
https://github.com/scipy-lectures/scipy-lecture-notes/issues/369#issuecomment-379578367

同じEditionのpdfファイルが更新されている。

読者側のバージョン管理

同じEditionのpdfファイルのバージョンが変わっていくと、読者は「どのバージョン?」のファイルを読んでいるか分からなくなる。

ファイル更新日付はpdfファイルへハイライトを追加したときなどに変更されるだろう。
ファイル作成日付は古い情報が残るかもしれない。この情報を見ることになるのだろうか。

読者が「ファイルが最新か」を知るには、pdfファイルの中身でなく、別の情報を管理・参照する必要がある。

ファイルの中身にrevisionが分かるようにドキュメントを用意する方がいいように思う。

Qiitaなどのドキュメント記載

QiitaなどのドキュメントでEdition 2017.1参照と記載していても、同じPDFファイルを取得できる可能性は低くなる。

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?