増田薫 @masudakaoru_ 思い出野郎Aチーム サックス（@O__Y__A__T） デザイン イラスト 絵画教室 マンガ 学生食堂ワンダフルワールド（連載中） いつか中華屋でチャーハンを(単行本発売中) オモコロ（不定期掲載）部屋 instagram.com/masudakaoru_/ 連絡先 mfzb224@gmail.com note.com/masudakaoru_/

僕は現在、TypeScript入門書『サバイバルTypeScript』を書いています。この本を書く過程で、わかりやすくて効果的な学習体験を提供するため、サンプルコードの制作には特別な注意を払っています。 サンプルコードは教育的な文書で重要な役割を果たします。しかし、よく考えられていないサンプルコードは学習者を混乱させ、思考の妨げになることさえあります。そのため、以下の6つのポイントに基づいてサンプルコードを制作するように心がけています。 シンプルにする クリアにする コメントで解説する 未導入の機能を避ける 完全な動作を示す コードの長さに注意する 1. シンプルにする コードは学習者が取り組んでいる特定の問題を解決する最短・最も簡単な方法を示すようにします。無関係な要素は省いて、特定のコンセプトや機能に焦点を当てます。 例: TypeScriptのforループを解説したいとき ✅Do:

牛帝 @gyutei_4koma 確か2010年くらい？に、当時すでにアメリカでははじまっていたAmazonの電子書籍サービス「Kindle」という黒船が、そう遠くないうちに日本に到来することがほぼ確定していて、このままだと出版社の売上がまるっとAmazonに持っていかれる年貢体制が確立してしまうから、いますぐに手を打つしかない！というのが各所でけっこう言われてたのですが、結局、出版社サイドはこれといった対策をせず、なんなら誰かが対策しようとした時には「俺たちの許可もなしに勝手なことするな！」と煙たがるまでして、その後、予想通りにKindleという黒船が到来して、Amazonに毎秒利益を持ってかれる体制を確立されてしまうのをただ見守ったということがありましたが、なんでそんなことになってしまったのか、いまだによく分からない 牛帝 @gyutei_4koma 何十年も前に鉄道会社で働いていたお