owned this note
owned this note
Published
Linked with GitHub
# 第3回ReadableCodeを英語で読む会
## What we do today
| 時間 |内容 |
|:------------ |:--------------|
| 14:45~15:00 | 開場・受付 |
| 15:00~15:10 | 口の運動してから自己紹介 |
| 15:10~15:20 | 他己紹介(ペアワーク) |
| 15:20~15:40 | Readable Code Chapter 2の振り返り |
| 15:40~15:45 | 休憩 |
| 15:45~16:10 | Readable Code Chapter 3の音読 |
| 16:10~16:30 | ペアで分からなかった単語確認 |
| 16:30~16:35 | 休憩 |
| 16:35~16:55 | 分からなかった単語を全体で意味調べ |
| 16:55~17:10 | 理解度確認テスト・英語で答え合わせ |
| 17:10~17:20 | 各自英語で今日のまとめ発表|
| 17:20~17:50 | 日本語で雑談コーナー |
| 17:50~18:00 | 閉会・後片付け |
## TODO
- [ ] 他己紹介で聞いた内容をattendeeに書いてもらうようアナウンスする
- [ ] 調べた単語を書いてくれる人を募集する
- [ ] グループ分けたほうがいいか確認する(みんなでやると読む量少なくならない?)
- [ ] Kindleの青ハイライトは英語のTipsなどに関する単語。オレンジは単純に自分が分からなかったものです。反意語や、似た単語を学ぶためのフックとして青ハイライトの単語を使っていきます。
- [ ] 時間があればNetflixを使った英語学習方法紹介
## 会の趣旨説明
Connpassの説明を読む。出来たら2週に1回くらいやっていきたい。
確認事項
* 日本語を使っても全然大丈夫です!できるだけ英語を使いましょう!
* こう言いたいけどどう言ったらいいか分からない。という時には聞いてください!(英語得意な人は手助けをお願いします!)
* Readable codeの英語テキストをもっているか(持っていない人同士で横並びになってもらう
* 日本語で読んできたか。
* 発音指摘してほしいって人いるか確認する
* 写真とか大丈夫か確認する
## Let us know about you!!
1. 呼んでほしい名前
Hello, I'm [Your name]. Please call me [your nick name].
2. エンジニア歴、使っている言語など
I have been working as a [Your job ex:web developer] for [months/years].
I use [Languages ex:PHP, JavaScript].
3. 英語歴、どれくらい学習してきたかなど
I have learning English for [months/years].
I have never learned English by myself.
4. 趣味とか一般的な自己紹介
When I have passtime, I like to do [something you like].
### This is my example.
Hello, I'm Toshihiro. Please call me Toshi.
I have been working as a web developer for 3 weeks. I use PHP.
I started learning English 10 years ago. I went to Austlaria and the Philippines for studying English. I have used English in job for 4 years.
When I have passtime, I like to do workout, going to karaoke alone.
Thanks.
### Attendees
* Connpassname(nickname), 職業, 英語歴, 趣味などペアワークで聞いた相手の情報をこの下に書いてください
ichiro
ios se 17year
english studying 20years
Australia supring vacation
## Readable Code Chapter 3の音読
###### 最初にQiitaのまとめ記事を読んで概要を把握する。
###### いい感じのところで区切ってやりましょう。
## 分からなかった単語やフレーズの確認
###### 質問する時は What does [word / phrase] mean? とするといいかもです!
###### 最初に英英で調べて、その後日英で調べる。
###### 調べた単語を使って、現場で使いそうな例文を作ってみよう!
* 調べた単語はここに、単語・意味・本文を追加していく。本文はこのリンクからコピペできます。 http://www.spooch.dk/Ebooks/IT%20Various/the_art_of_readable_code.pdf
###### 書き方の例として、以下のように書いていただけると嬉しいです↓
テンプレート
本文:
分からなかった単語:
単語の意味:
例
本文: Attaching extra information to a name, by using a suffix or prefix.
分からなかった単語: suffix
単語の意味: 語尾につける言葉
Actively scrutinize your names by asking yourself, “What other meanings could
someone interpret from this name?”
scrutinize
精査する
This step will help you
spot those ambiguous names so you can change them.
ambiguous
曖昧な
For the examples in this chapter, we’re going to “think aloud” as we discuss the
misinterpretations of each name we see, and then pick better names.
think aloud
考えていることを声にして整理する
<=
less than equal
>=
greather than equal
It’s best to avoid the name filter because it’s so easily misconstrued.
misconstrued
誤解する
If you want “to get rid of,” a better name
is exclude().
to get rid of
除外する、日常会話だとゴミを捨てる時に使う
The second way (truncation) is most likely,
truncation
取り除く、削除する
Rather than leave your reader with any nagging doubt,
nagging
ガミガミ言う、うるさくいう、しつこい
However, the parameter name length is also to blame.
blame
責める、naggingと似ている
This code has a classic off-by-one bug.
off-by-one
ひとつずつずれている、
off-by-one bug:バグの一種
it’s not clear whether you mean “up to” or “up to and including.”
up tp
〜まで、上限がある,セールとかの表現で使われる
Prefer begin and end for Inclusive/Exclusive Ranges
inclusive
含む
Unfortunately, English doesn’t have a succinct word for “just
past the last value.”
succinct
簡潔に
Finally, it’s best to avoid negated terms in a name.
negated
反対の、
Depending on how you read it (no pun intended)
no pun intended
ギャグです、笑ってください
Some names are misleading because the user has a preconceived idea of what the name means
preconceived
先入観
In this case, the implementation of getMean() is to iterate over past data and calculate the mean
on the fly.
on the fly
その場で、すぐに、急いで、事前に準備なしで
The following code was the cause of a very
difficult-to-find bug that made one of our servers slow down to a crawl:
crawl
はいつくばる、のろのろすすむ
Thankfully, the latest C++ standard
now mandates size() to be O(1)
mandate
権限がある
## 確認した単語やフレーズを使って英語で内容についてディスカッション
###### もし意見を言うのが難しい時は I think [A] is [good / bad]. Because ... とするといいかもです!
###### 相手に意見を聞く時は What do you think about [聞きたいこと] と聞くといいかもです!
###### 言いたいことがあってもうまく英語で言えない時は、先に日本語で説明してください!その後英語でみんなで言い方を考えましょう!
## Chapter 3 理解度確認テスト
https://forms.gle/8YHm6ojoWFn6kJBR8
## 各自英語で今日のまとめ発表
###### まとめを言う時は The takeaway from this event is ... で始めるといいかもです!(takeaway means 今日の学びみたいな感じ)
## 日本語で雑談コーナー
## 閉会・後片付け