gemmaro · gemmaro · Jul 10, 2023 · Jul 10, 2023 · Jul 11, 2023 · Jul 11, 2023
diff --git a/.github/workflows/mdbook.yml b/.github/workflows/mdbook.yml
@@ -4,7 +4,7 @@ on:
   push:
     branches: [ja]
     # branches: [master]
-  pull_request:
+  # pull_request:
 
 jobs:
   deploy:

diff --git a/.po4a-version b/.po4a-version
@@ -1,4 +1,4 @@
-po4a version 0.68.
+po4a version 0.69.
 Written by Martin Quinson and Denis Barbier.
 
 Copyright © 2002-2022 Software in the Public Interest, Inc.

diff --git a/.textlintrc.json b/.textlintrc.json
@@ -5,10 +5,15 @@
     },
     "preset-ja-technical-writing": {
       "ja-no-mixed-period": {
-        "allowPeriodMarks": ["、", "…"]
+        "allowPeriodMarks": [
+          "、",
+          "…"
+        ]
       },
       "ja-no-successive-word": {
-        "allow": ["…"]
+        "allow": [
+          "…"
+        ]
       },
       "ja-no-weak-phrase": false,
       "max-kanji-continuous-len": {
@@ -34,15 +39,26 @@
           "配列内包表記",
           "配列型構築子",
           "関数合成演算子",
-          "領域特化言語"
+          "領域特化言語",
+          "可変参照領域"
         ]
       },
       "no-doubled-joshi": false,
       "no-exclamation-question-mark": {
         "allowHalfWidthExclamation": true,
         "allowFullWidthExclamation": true
       },
-      "sentence-length": false
+      "sentence-length": false,
+      "ja-no-redundant-expression": {
+        "dictOptions": {
+          "dict6": {
+            "allows": [
+              "動作を実行",
+              "プログラムを実行"
+            ]
+          }
+        }
+      }
     }
   }
 }
diff --git a/CONTRIBUTING.ja.md b/CONTRIBUTING.ja.md
@@ -0,0 +1,15 @@
+# 貢献
+
+本書で何かしら改善になるものを見付けたらPRやイシューを開いてください。
+
+フィードバックに感謝します。
+
+## 章のテキストを編集する
+
+テキストの変更をローカルで見てみるには、[mdbook](https://github.com/rust-lang/mdBook)をインストールし、以下のコマンドをリポジトリのルートで走らせます。
+
+```sh
+mdbook serve -o
+```
+
+readmeファイルへの変更毎に描画されたwebページが自動的に再読み込みされます。
diff --git a/manifest.scm b/manifest.scm
@@ -1,5 +1,4 @@
 (use-modules (gnu packages node)
-             (gnu packages gettext)
-             (gemmaro packages mdbook))
+             (gnu packages gettext))
 
-(packages->manifest (list node-lts po4a mdbook))
+(packages->manifest (list node-lts po4a))
diff --git a/po4a.cfg b/po4a.cfg
@@ -56,3 +56,6 @@
 
 [type:text] text/chapter9.md \
             $lang:text-ja/chapter9.md
+
+[type:text] CONTRIBUTING.md \
+            $lang:CONTRIBUTING.ja.md
diff --git a/text-ja/chapter1.md b/text-ja/chapter1.md
diff --git a/text-ja/chapter10.md b/text-ja/chapter10.md
diff --git a/text-ja/chapter11.md b/text-ja/chapter11.md
diff --git a/text-ja/chapter12.md b/text-ja/chapter12.md
diff --git a/text-ja/chapter13.md b/text-ja/chapter13.md
diff --git a/text-ja/chapter14.md b/text-ja/chapter14.md
diff --git a/text-ja/chapter2.md b/text-ja/chapter2.md
@@ -2,8 +2,8 @@
 
 ## この章の目標
 
-この章では実際のPureScriptの開発環境を立ち上げ、幾つかの演習を解き、この本で提供されているテストを使って答えを確認します。
-もし映像を見る学習の仕方が合っているようでしたら、[この章を通しで進めるビデオ](https://www.youtube.com/watch?v=GPjPwb6d-70)が役に立つでしょう。
+本章では実際のPureScriptの開発環境を立ち上げ、幾つかの演習を解き、本書で提供されているテストを使って答えを確認します。
+もし映像を見る学習の仕方が合っているようでしたら、[本章を通しで進めるビデオ](https://www.youtube.com/watch?v=GPjPwb6d-70)が役に立つでしょう。
 
 ## 環境構築
 
@@ -22,13 +22,16 @@ PureScriptを書く上で（例えば本書の演習を解くなど）お好み
 
 ## 演習を解く
 
-ここまでで必要な開発ツールをインストールできているので、この本のリポジトリをクローンしてください。
+ここまでで必要な開発ツールをインストールできているので、本書のリポジトリをクローンしてください。
 
 ```sh
 git clone https://github.com/purescript-contrib/purescript-book.git
 ```
 
-本のリポジトリにはPureScriptのコード例とそれぞれの章に付属する演習のための単体テストが含まれます。演習の解法を白紙に戻すために必要な初期設定があり、この設定をすることで解く準備ができます。この工程は`resetSolutions.sh`スクリプトを使えば簡単にできます。また`removeAnchors.sh`スクリプトで全てのアンカーコメントを取り除いておくのもよいでしょう（これらのアンカーはコードスニペットを本の変換後のMarkdownにコピーするために使われており、自分のローカルリポジトリではこのアンカーで散らかっていないほうがよいでしょう）。
+本書のリポジトリにはPureScriptのコード例と各章に付属する演習のための単体テストが含まれます。
+演習の解法を白紙に戻すために必要な初期設定があり、この設定をすることで解く準備ができます。
+この工程は`resetSolutions.sh`スクリプトを使えば簡単にできます。
+また`removeAnchors.sh`スクリプトで全てのアンカーコメントを取り除いておくと良いでしょう（これらのアンカーはコード片を本書のMarkdownから書き出した媒体に複製するために使われており、自分のローカルリポジトリではこのアンカーで散らかっていないほうが良いでしょう）。
 
 ```sh
 cd purescript-book
@@ -55,15 +58,15 @@ spago test
 All 2 tests passed! 🎉
 ```
 
-なお、`answer`関数（`src/Euler.purs`にあります）は、任意の整数以下の3と5の倍数を見付けるように変更されています。
-この`answer`関数のためのテストスート（`test/Main.purs`にあります）ははじめの手引きの冒頭にあるテストよりも網羅的です。
-はじめの章を読んでいる間はこのテストフレームワークの仕組みを理解しようと思い詰めなくて大丈夫です。
+なお、（`src/Euler.purs`にある）`answer`関数は任意の整数以下の3と5の倍数を見付けるように変更されています。
+（`test/Main.purs`にある）この`answer`関数のためのテストスートははじめの手引きの冒頭にあるテストよりも網羅的です。
+前の方の章を読んでいる間はこのテストフレームワークの仕組みを理解しようと思い詰めなくて大丈夫です。
 
-本の残りの部分には多くの演習が含まれます。
+本書の残りの部分には多くの演習が含まれます。
 `Test.MySolutions`モジュール (`test/MySolutions.purs`)
 に自分の解法を書けば、提供されているテストスートを使って確認できます。
 
-テスト駆動開発のスタイルでこの次の演習を一緒に進めてみましょう。
+テスト駆動開発でこの次の演習を一緒に進めてみましょう。
 
 ## 演習
 
@@ -93,7 +96,8 @@ at test/Main.purs:21:27 - 21:35 (line 21, column 27 - line 21, column 35)
   Unknown value diagonal
 ```
 
-まずは、この関数が欠陥のあるバージョンになっているときに何が起こるのか見てみましょう。以下のコードを`test/MySolutions.purs`に追加してください。
+まずはこの関数に欠陥があるときに何が起こるのか見てみましょう。
+以下のコードを`test/MySolutions.purs`に追加してください。
 
 ```hs
 import Data.Number (sqrt)
@@ -147,14 +151,14 @@ All 4 tests passed! 🎉
 この章ではPureScriptコンパイラとSpagoツールをインストールしました。
 演習の解答の書き方と正しさの確認方法も学びました。
 
-この先の章にはもっと沢山の演習があり、それらに取り組むうちに学習の助けになっているでしょう。
-演習のどこかでお手上げになったら、この本の[困ったときは](chapter1.ja.md#getting-help)の節に挙げられているコミュニティの資料のどれかを見てみたり、この[本のリポジトリ](https://github.com/purescript-contrib/purescript-book/issues)にイシューを報告したりできます。
-こうした演習の敷居を下げることに繋がる読者のフィードバックが、本の向上の助けになっています。
+この先の章にはもっと沢山の演習があり、それらに取り組むうちに内容を学ぶ助けになっているでしょう。
+演習のどこかでお手上げになったら、本書の[困ったときは](chapter1.ja.md#getting-help)の節に挙げられているコミュニティの資料のどれかに手を伸ばしたり、[本書のリポジトリ](https://github.com/purescript-contrib/purescript-book/issues)でイシューを報告したりできます。
+こうした演習の敷居を下げることに繋がる読者のフィードバックのお陰で本書が改善されています。
 
 章の全ての演習を解いたら、`no-peeking/Solutions.purs`にあるものと解答とを比べられます。
-ただしカンニングしてはだめで、これらの演習を誠実に自力で解く労力を払わないことがないようにしてください。
+カンニングはせず、演習を誠実に自力で解く労力を割いてください。
 そしてたとえ行き詰まったにしても、まずはコミュニティメンバーに尋ねてみるようにしてください。
-演習のネタバレをするよりも、小さな手掛かりをあげたいからです。
-もっとエレガントな解法（とはいえ本の内容で押さえられている知識のみを必要とするもの）を見つけたときはPRを送ってください。
+ネタバレをするよりも小さな手掛かりをあげたいからです。
+もっとエレガントな解法（とはいえ本書で押さえられている知識のみで済むもの）を見つけたときはPRを送ってください。
 
 リポジトリは継続して改訂されているため、それぞれの新しい章を始める前に更新を確認するようにしてください。