Update docs

Author: rinatz

docs/ch03-01-classes.md

@@ -30,7 +30,14 @@ if __name__ == '__main__':
 
 ## `__init__()`
 
-`__init__()` はインスタンス化するときに必ず呼び出される初期化関数です。引数には初期化に必要な値を渡すことができます。ただし第 1 引数は必ず `self` という引数にして下さい。`self` については後述します。
+`__init__()` はいわゆるコンストラクタです。コンストラクタには 2 つの役割があります。
+
+1. インスタンス化をするときに最初に呼び出される
+1. クラスのメンバ変数を定義し、それを初期化する
+
+クラスにどのようなメンバ変数を用意したいかということも含めてコンストラクタで定義することに注意して下さい。
+
+引数には初期化に必要な値を渡すことができます。ただし第 1 引数は必ず `self` という引数にして下さい。`self` については後述します。
 
 クラスで扱うメンバ変数を定義したいときは次のようにします。
 

docs/ch04-02-packages.md

@@ -57,14 +57,17 @@ if __name__ == '__main__':
 
 `パッケージ名.モジュール名.関数名` のように `.` で区切って関数にアクセスすることができます。ちなみにパッケージ内にパッケージが含まれていても問題ありません。
 
-!!! warning "パッケージ名の命名規則"
-    パッケージ名に `-` を使用するのは避けましょう。なぜなら `xxx-yyy` というパッケージを作ったとき
+!!! warning "モジュール・パッケージ名の命名規則"
+    モジュール名・パッケージ名に `-` を使用するのは避けましょう。なぜなら `xxx-yyy` というモジュール・パッケージを作ったとき
 
     ```python
     import xxx-yyy
     ```
 
-    のように import することになりますが `-` が引き算だと解釈されてしまいます。一般的にパッケージ名は次のルールを守るべきとされています。
+    のように import することになりますが `-` が引き算だと解釈されてしまいます。一般的に命名規則は次のようなるーるになっています。
 
-    - 区切り文字は禁止（`-` 以外も）
     - 全て小文字
+    - パッケージ名に区切り文字は禁止
+    - モジュール名の区切り文字は `_` を使用
+
+    モジュール名であっても区切り文字はできるだけ使用しない方が好まれます。パッケージ名は例え複数語であっても区切り文字は使用しません。

docs/ch04-03-pip.md

@@ -1 +1,41 @@
 # pip
+
+`pip` はインターネットで公開されている Python パッケージを取得するためのパッケージ管理ツールです。
+
+## 使い方
+
+[requests] という HTTP に関する機能を取り扱う有名なライブラリがあります。これを `pip` で取得して使ってみましょう。
+
+[requests]: http://docs.python-requests.org/en/master/
+
+ターミナル上で次のコマンドを実行して下さい。
+
+```shell
+$ pip install requests
+```
+
+!!! note
+    Windows の場合は下記のコマンドを実行して下さい。
+
+    $ py -m pip install requests
+
+成功したら次のようなソースコードを書いてみましょう。
+
+```python
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+
+import requests
+
+
+def main():
+    response = requests.get('http://example.com')
+    print(response.text)
+
+
+if __name__ == '__main__':
+    main()
+```
+
+実行すると http://example.com のページの HTML 文字列が出力されると思います。

docs/index.md

@@ -6,7 +6,7 @@
 
 このサイトは Python を学ぶ人向けのオンライン学習サイトです。
 
-## 誰向けのサイトか
+## 対象
 
 - Python を初めて学ぶ人
 - プログラム言語を 1 つ以上経験したことのある人