## はじめに
リーダブルコードを読んで、勉強になったこと、感じたことをまとめていきます。

## 目次
#### 理解しやすいコードとは
#### ・表面上の改善

## コードを書く上での大前提

・コードは理解しなければならない
・コードは他の人が、最短時間で理解できるように書かないといけない
1つずつ説明していきます。

#### ・コードは理解しなければならない
これがコードを書くうえで、一番大事になる原則としている。
#### ・コードは他の人が、最短時間で理解できるように書かないといけない
コードを読む際に、処理内容が分かりにくいコードよりも、わかりやすいこコードの方が良いに決まっています。
わかりにくいコードを書いていると、周りの開発者はもちろん、何ヶ月後かに、自分で見返した時にも、コードを読むのに労力を使ってしまいます。

## 表面上の改善
##### *鍵となる考え*
・明確な単語を選ぶ
・汎用的な名前は避ける
・抽象的な名前よりも具体的な名前を使う。
・接尾辞や接尾頭を使って、情報を追加する
・名前の長さを決める


#### 明確な単語を選ぶ
例えば「getPage」という名前は、ページをどこから取ってくるのかわからない。インターネットから取得するのであれば、「FetchPage」、「DownloadPage」などが良い。

#### 汎用的な名前は避ける
例えば、「tmp」「retval」「foo」のような名前は付けないようにしたほうがいい。
単語自体に情報が無いので、使うのであれば、それ相応の理由を用意する。

#### 抽象的な名前よりも具体的な名前を使う。
名前は短いコメントのようなものなので、絶対に知らせなきゃいけない情報があれば、適切な単語を選び、変数名に追加する

#### 名前の長さを決める
この本では、変数の長さは、長いのが問題ではないが、できるだけ短くすることをおすすめしている。
理由としては、長い変数は覚えにくいし、画面を占領してしまうからです。
頭文字と省略形はプロジェクト固有の省略は良くない。理由は、新しく入ってきたメンバーはその変数の意味を理解できないからである。
不要な単語も投げ捨てた方がいい。例えば、CovertToString()をToString()にしてもあまり変わらない。
変数名はシンプルにしよう。


## 誤解されない名前
##### *鍵となる考え*
・最善の名前とは、誤解されない名前

自分の書いているコードが、自分の意図を正確に伝えるようにする。
プログラミングの英単語は、filterやlength、limitなど曖昧な意味の単語が多い。
例えば、上下の限界値を決めるときは、maxやminなどを使う。包含的範囲であればfirstやlastなどを使うなど、工夫をしていくことが必要である。

## 美しさ
#### なぜコードの美しさが必要なのか
プログラミングの時間のほとんどはコードを読む時間です。読みやすいコードは、コーディングのミスを減らし、誰でも使いやすいコードになるのです。
##### *鍵となる考え*
・複数のコードブロックで同じようなことをしていたら、シルエットも同じようなものにする。

・コードの列を整列すれば、概要が把握しやすくなる
・空行を使って大きなブロックを論理的な段落に分ける。


## 最後に
全ての内容を書ききれていないので、また追記していきます。
[cv:issue_marketplace_engineer]

## はじめに
リーダブルコードを読んで、勉強になったこと、感じたことをまとめていきます。

## 目次
#### 理解しやすいコードとは
#### ・表面上の改善

## コードを書く上での大前提

・コードは理解しなければならない
・コードは他の人が、最短時間で理解できるように書かないといけない
1つずつ説明していきます。

#### ・コードは理解しなければならない
これがコードを書くうえで、一番大事になる原則としている。
#### ・コードは他の人が、最短時間で理解できるように書かないといけない
コードを読む際に、処理内容が分かりにくいコードよりも、わかりやすいこコードの方が良いに決まっています。
わかりにくいコードを書いていると、周りの開発者はもちろん、何ヶ月後かに、自分で見返した時にも、コードを読むのに労力を使ってしまいます。

## 表面上の改善
##### *鍵となる考え*
・明確な単語を選ぶ
・汎用的な名前は避ける
・抽象的な名前よりも具体的な名前を使う。
・接尾辞や接尾頭を使って、情報を追加する
・名前の長さを決める


#### 明確な単語を選ぶ
例えば「getPage」という名前は、ページをどこから取ってくるのかわからない。インターネットから取得するのであれば、「FetchPage」、「DownloadPage」などが良い。

#### 汎用的な名前は避ける
例えば、「tmp」「retval」「foo」のような名前は付けないようにしたほうがいい。
単語自体に情報が無いので、使うのであれば、それ相応の理由を用意する。

#### 抽象的な名前よりも具体的な名前を使う。
名前は短いコメントのようなものなので、絶対に知らせなきゃいけない情報があれば、適切な単語を選び、変数名に追加する

#### 名前の長さを決める
この本では、変数の長さは、長いのが問題ではないが、できるだけ短くすることをおすすめしている。
理由としては、長い変数は覚えにくいし、画面を占領してしまうからです。
頭文字と省略形はプロジェクト固有の省略は良くない。理由は、新しく入ってきたメンバーはその変数の意味を理解できないからである。
不要な単語も投げ捨てた方がいい。例えば、CovertToString()をToString()にしてもあまり変わらない。
変数名はシンプルにしよう。


## 誤解されない名前
##### *鍵となる考え*
・最善の名前とは、誤解されない名前

自分の書いているコードが、自分の意図を正確に伝えるようにする。
プログラミングの英単語は、filterやlength、limitなど曖昧な意味の単語が多い。
例えば、上下の限界値を決めるときは、maxやminなどを使う。包含的範囲であればfirstやlastなどを使うなど、工夫をしていくことが必要である。

## 美しさ
#### なぜコードの美しさが必要なのか
プログラミングの時間のほとんどはコードを読む時間です。読みやすいコードは、コーディングのミスを減らし、誰でも使いやすいコードになるのです。
##### *鍵となる考え*
・複数のコードブロックで同じようなことをしていたら、シルエットも同じようなものにする。

・コードの列を整列すれば、概要が把握しやすくなる
・空行を使って大きなブロックを論理的な段落に分ける。


## 最後に
全ての内容を書ききれていないので、また追記していきます。
[![image](https://firebasestorage.googleapis.com/v0/b/issue-pro-42602.appspot.com/o/topics%2F17fa658b-53c7-4ca0-a28b-e588ed1bd371?alt=media&token=2c00afff-85ff-4428-8d15-696ab676dcb0)](https://i-ssue.com/lp/check_salary)

はじめに

目次

理解しやすいコードとは

・表面上の改善

コードを書く上での大前提

・コードは理解しなければならない

続きを読むには単価診断を受けてください（30秒）