Bug(バグ) #1566
完了日本語バージョンアップドキュメントの表現、文言の修正
100%
説明
現象¶
- doc/ja/OpenPNE3_Version_Up_Guide.txt の 「OpenPNE 3.2.0 + から」の文言がわかりにくいとの指摘があるため、この文言を含め、英語、日本語版でのドキュメントの文言の修正を行う
- 3.6の同梱されているのに"OpenPNE 3.4 バージョンアップ手順"という題名になっているため混乱を招く可能性があるので、適切なバージョン表記に変更する
さらに,3.6beta11以前からのバージョンアップ時にメンバーの設定画面(member/config)において下記の3つの項目が表示されなくなるため,使用する場合には管理画面(pc_backend.php/sns/config/category/general)より「使用する」を選択する必要がある旨を記述をお願いします.なお,対象となる問題は本チケットでの対応を行うため #2289 はinvalidとします.
- 「言語とタイムゾーンの設定」
- 「外部サービスとの接続設定」
- 「OpenID の設定」
英語版に関しては,#1567 で対応いたします.
原因¶
修正内容¶
Yuya Watanabe さんが約13年前に更新
- ステータス を Accepted(着手) から Pending Review(レビュー待ち) に変更
- 進捗率 を 0 から 50 に変更
Kousuke Ebihara さんが約13年前に更新
- ステータス を Pending Review(レビュー待ち) から Rejected(差し戻し) に変更
このドキュメントは、 OpenPNE 3.2.0 以上のバージョン から OpenPNE 3.6.0 へのバージョンアップ作業の手順を示したものです。
アップグレード先のバージョンは OpenPNE 3.6.0 に限定されません。元々の "OpenPNE 3.4.x" という表記にあわせて "OpenPNE 3.6.x" と表記するか、もしくは "OpenPNE 3.6" と表記するべきです。
Fumie Toyooka さんが約13年前に更新
- 題名 を セットアップ、バージョンアップドキュメントの表現、文言の修正 から 日本語バージョンアップドキュメントの表現、文言の修正 に変更
- 説明 を更新 (差分)
Minoru Takai さんが約13年前に更新
note-7 に加えて、補足します。
個人的な意見なのですが、
このドキュメントは、 OpenPNE 3.2.0 以上のバージョン から OpenPNE 3.6.0 へのバージョンアップ作業の手順を示したものです。
という記述に関して、 OpenPNE 3.2.0 以上と書くと、3.2.0, 3.2.1, 3.2.2, ... 3.2.x までのみを想起する可能性があります。ここでは 3.4.0, ..., 3.4.x を含み、更にどうやらメジャーバージョンアップだけでなくマイナーバージョンアップ手順としても有効らしく 3.6beta1, ..., 3.6beta14, 3.6RC1, 3.6.0, ..., 3.6.x も含むようです。
バージョンアップ前 | バージョンアップ後 | |
(1) | OpenPNE 3.2.0 以上 | OpenPNE 3.6.0 |
(2) | OpenPNE 3.2.0 以上 | OpenPNE 3.6.x |
(3) | OpenPNE 3.2.0 以上 | OpenPNE 3.6 |
(4) | OpenPNE 3.2 以上 | OpenPNE 3.6.x |
(5) | OpenPNE 3.2 以上 | OpenPNE 3.6 |
note-7 では (1) に対して、(2) または (3) にすべきという指摘でしたが、それに加えて (4) または (5) にした方がよいのではないかといった指摘です。
しかし (2) に対する (4) が分かりやすいというわけでもない気がするので、次のように記述してはどうでしょうか。(3.2.0 と記述、「全ての」バージョンと記述、3.6.x と記述、メジャーおよびマイナーを括弧で記述)
- このドキュメントは、 OpenPNE 3.2.0 以上の全てのバージョンから OpenPNE 3.6.x へのバージョンアップ作業(メジャーバージョンアップ、およびマイナーバージョンアップ)の手順を示したものです。
追記ですが、このコメントでの指摘内容は #1514 で指摘されている対応予定項目の一つでしたね。
Fumie Toyooka さんが約13年前に更新
関係しているチケット #2330 が本チケットと問題点が重複していて,紛らわしいので,その内容を転記します.
#2330 日本語バージョンアップ手順(3.6.0向け)に管理画面の設定手順を追記する.¶
Overview (概要)¶
3.6beta11以前からのバージョンアップ時にメンバーの設定画面(member/config)において下記の3つの項目が表示されなくなるため,使用する場合には管理画面(pc_backend.php/sns/config/category/general)より「使用する」を選択する必要がある旨を記述をお願いします.なお,対象となる問題は本チケットでの対応を行うため #2289 はinvalidとします. * 「言語とタイムゾーンの設定」 * 「外部サービスとの接続設定」 * 「OpenID の設定」 本チケットでは,日本語のバージョンアップ手順に以上の項目を追記する修正を行います. 英語版に関しては, #1567 で対応します. 手順書に記載されているバージョンが 3.4 になっている問題に関しては, #1566 で対応いたします.
更新状況(古い順に書いています)¶
Fumie Toyooka は書きました:¶
https://github.com/fumicos/OpenPNE3/commit/4e6f9ac6532dea8a6f5a6cca3818c03ff8dcfbe5
isao sano は書きました:¶
ドキュメント内の文言の3.6と表示される部分がすべて3.4と表示されています。
差し戻します。
Fumie Toyooka は書きました:¶
ドキュメント内の文言の3.6と表示される部分がすべて3.4と表示されています。
差し戻します。これはチケット #1566 で対応いたします.
英語版に関しては, #1567 で対応いたします.
Imamura Mutsumi は書きました:¶
http://redmine.openpne.jp/issues/2330#note-6
のレビュー以降修正は加えていませんのでテスト待ちとします。
Fumie Toyooka さんが約13年前に更新
- ステータス を Accepted(着手) から Pending Review(レビュー待ち) に変更
高井さんの助言も含めて修正し,
OpenPNE3 に pull request 済みです.
ブランチ等混乱を招く状況では,ありますが何卒宜しくお願いいたします.
Kousuke Ebihara さんが約13年前に更新
修正がおこなわれているコミットは https://github.com/fumicos/OpenPNE3/commit/40c4482c76799fbc5b1cd19b2243b4d607ecb483 です。
Yuya Watanabe さんが約13年前に更新
mergeを行ったため 71aa5c63 で差分が表示されないためgithubの方のコミットも記載しておきます.
https://github.com/openpne/OpenPNE3/commit/71aa5c63a1e4bb0b4c181b4ba4f7c29d12bd3c18
Kousuke Ebihara さんが約13年前に更新
チケット番号の誤りによりこのチケットに紐付いていませんが、 https://github.com/openpne/OpenPNE3/commit/eb8e60987599a0b152dff2b5d240a2f2bb436431 の変更も本チケットに対しておこなわれたものです。
Kousuke Ebihara さんが約13年前に更新
また、 31ccc3cf がこのチケットに紐付いてしまっていますが、このコミットは stable-3.6.x に対して追加されたものであり、このチケットに紐付いているのは誤りです。
Kousuke Ebihara さんが約13年前に更新
- ステータス を Pending Review(レビュー待ち) から Pending Testing(テスト待ち) に変更
- 進捗率 を 50 から 70 に変更
Mutsumi Imamura さんが約13年前に更新
- ステータス を Pending Testing(テスト待ち) から Rejected(差し戻し) に変更
- 進捗率 を 70 から 50 に変更
37行目に
cp /path/to/old/OpenPNE3/config/ProjectConfiguration.class.php.sample /path/to/new/OpenPNE3/config/ProjectConfiguration.class.php
という記述がありますが、古いバージョンのProjectConfiguration.class.php.sampleをコピーするのではなく3.6.xのProjectConfiguration.class.php.sampleをコピーするのが正しいです。
ご確認ください。
Yuya Watanabe さんが約13年前に更新
note-23の指摘部分に関して気がついたのですが,その直前の文では下記のような記述が存在します.
OpenPNE 3.6 の config/ProjectConfiguration.class.php.sample を config/ProjectConfiguration.class.php にコピーします。
指摘対象となった37行目はこの文のコマンド例として記載されているのであるとすると,古いバージョンからProjectConfiguration.class.phpのファイルをコピーしてくることは誤りです.(追記:この点はnote-23で指摘されている内容でした.).また,このコマンド例を行うディレクトリは新たに設置する3.6のソースであると思うのでOpenPNE.yml.sampleファイルのコピー及び旧OpenPNE.ymlの設定を新環境に反映する手順の記述も必要になると思います.
wa ta さんが約13年前に更新
- ステータス を Rejected(差し戻し) から Pending Review(レビュー待ち) に変更
更新履歴 4cd22a26fb0706699b0778e6bd02b01337e2239e で適用されました。
Kousuke Ebihara さんが約13年前に更新
- ステータス を Pending Review(レビュー待ち) から Pending Testing(テスト待ち) に変更
- 進捗率 を 50 から 70 に変更
Yuma Sakata さんが約13年前に更新
- ステータス を Pending Testing(テスト待ち) から Fixed(完了) に変更
- 進捗率 を 70 から 100 に変更
テストOKです。