N予備校のプログラミング教材編集に約3年携わって得られた知見 - Qiita

プログラミング教材の編集に携わって3年経ち、いろいろな知見が貯まってきたので「ドキュメント執筆に関するアウトプット」を行ってみようと思います。 自己紹介 ドワンゴでN予備校のコンテンツ制作に携わっているアルバイトの1人、 ryo-a です。 現在の本業は大学生で、慶應義塾大学にて計量経済学の分析に関係するあれこれをやっています。4月から慶應義塾大学大学院に進学予定です。交通関係の情報や大規模データの処理を好んでおり、最近は地理空間情報処理ツールや各種CLIツールなどを作っていたりします。 2017年4月よりアルバイトとしてドワンゴで働いており、主にプログラミング教材の制作補助に関わっています。働きはじめて3年近く経ち、色々な知見が貯まってきたので教材編集を通じて得られた知見を書いてみます。 併せて、プログラミング教育におけるノウハウが業界内で共有されていけばいいな、とも思います。 （個人的

[yasushicohi]

N予備校のwebアプリの教材やってるけど、本当に丁寧。実際に必要となる環境や知識と技術が盛り込まれている。 これ月千円は、かなり価格破壊。

[sifue]

N予備校で教材制作をやってくれている学生アルバイトメンバーがプログラミング教材制作のノウハウについてまとめてくれました！

[yarumato]

“英語表記されたものは初心者のハードルになる。　初出の英単語には括弧書きで読み方を付ける。一般的に通用している自然なカタカナ表記に寄せる。ping（×:ピング、○:ピン）のような明確な誤用は正しい発音を表記”

[d4-1977]

スゴク丁寧に解説してある…スゴイ。 あえて間違えさせるっていうのは、思いつかなかった！ナルホド

[takatama]

N予備校の教材で一番好きなのは、わざと間違わせるところ。間違っても大したことはない、のがプログラミングのいいところだから

[zoe302]

よさそう、後で読む:eyes:

[nilab]

N予備校のプログラミング教材編集に約3年携わって得られた知見 - Qiita

[june29]

めちゃいいなあ。

[Mrk1869]

“気にすべき差異・気にすべきでない差異の違いが難しい”

[udzura]

“教材序盤はエンジニア目線で「丁寧すぎる」くらいがちょうど良い”それなんですよ...

[kinushu]

初心者に向けて色々考えられててよいですね…！

[marmot1123]

良い。

[iga_k]

これは知見。勉強になる。スマホとPCの違いとか、読み方とか。

[hidecharo]

「ドキュメント執筆に関するアウトプット」You are interested in Documenter and Programming.

[poleight]

“序盤に「HTMLタグをあえて間違ってみる」という手順を追加してみました。これにより、間違った場合の表示と対処を学ぶだけでなく、「コンピュータへの命令は 1 文字でも間違うと、予期しない動作をするものだ」と”

[Yaju3D]

読み方大事。聞いたことがある単語でも、英語の綴りだけでは分からないこともある。例 rhythm リズム、schema スキーマ、physical フィジカル

[hara_boon]

“プログラミング以外の部分への配慮”

[kazuau]

“ /íŋ/”は「イング」でいいんだってば。キングとかリングとかシングとかウィングとか全部改めさせるのか？

[yodelx]

“あえて「間違わせる」手順も時には大事”"立場（社員orアルバイト、在籍年数etc）に関係なくお互いのコードや文章に対して客観的にレビューできる雰囲気があります。いわゆる心理的安全性が高い環境" とても良い記事