function.md改善案

[nafuka11]

• Teaching-Assistant-Python/docs/function.md

  Line 3 in 215756c

  - テストコードからも利用するが、下記の流れが進めやすい

  • 「下記の流れで関数を作っていくと進めやすい」のように、具体的な表記にした方が分かりやすいかと思います。

• Teaching-Assistant-Python/docs/function.md

  Line 23 in 215756c

  - `return`: 関数を利用した場所に渡す値

  • 戻り値と表記した方が良いかと思います。

• Teaching-Assistant-Python/docs/function.md

  Lines 25 to 29 in 215756c

  	Paizaでも型ヒントが使えるようになったが、型のあるコードは保守性が高くなりやすい（メンテナンスしやすい）ので、**型ヒントは書かなくてもいいけど、書いた方がエンジニア（未来の同僚）からのウケは良い**という実感がある
  	型のある言語（JavaとかTypeScriptとか）にも移行しやすくなると思うし
  	関数は外の変数の変化から影響を受けないし、中の変数の変化で外へ影響を与えることもできない
  	引数で外から値を受け取り、`return`で戻り値を元のコードへ渡すことができる

  1. 型ヒントの役割、型のあるコードは何故保守性が高くなるか、説明が必要だと思います。

  2. 説明の順序が

     • 型ヒントのメリット
     • 関数のメリット
     • 関数の役割

     の順に説明していますが、

     • 関数の役割
     • 関数のメリット
     • 型ヒントの役割・メリット

     の順に説明した方が分かりやすいと思います。

• コードブロックの言語指定は python= だと反映されないようです。
• 改行が反映されてない箇所があります。