私たちは本を書いていません! プログラミングマニュアル作成の実務経験

このメモを書くというアイデアは、「本を書きました! プログラミングに関する本を出版した実務経験 その著者のように、私は年の初めに執筆を開始し、4月中​​旬までに終了し、ほぼ同じボリュームで働きました。 しかし、作業は少し異なります-プログラミング言語Cのマニュアル



それ以前は、プログラミングやその他のことに関するコースやクラスの形で教材を書いた経験があり、ティーンエイジャーにプログラミングの方法を教えた経験がありました。 今回書いたコースは、主に市民を対象としており、14〜15歳から始まっており、他の言語によるプログラミングの基礎にすでに精通しています。



そのような手当の必要性は、前学年の12月の初めまでに熟しました。 12月は、Cに関する既存の文献とマニュアルを見るために去りました。見たものの中に価値のある作品があったにもかかわらず、どれも適していませんでした。 たとえば、よく推奨される有名なK&Rエディションは初心者には適していません。 他の出版物は膨大であったか、客観的な知識を提供していませんでした。 30ペア(60アカデミックアワー)を超えないように設計されたマニュアルが必要でした。



コースを書くときに最初に必要なことは、おおよその計画とおおよそのクラスの内容を開発することです。 これは、どの特定のレッスンで何が研究され、何が習得されているかをどの順序で示す必要があることを意味します。 これには約1週間かかります。



次に、各レッスンを順番に書くときが来ます。 パフォーマンスの概要:

  1. 現在のレッスンでは、資料の表示順序、各新しいコンセプトの実例、レッスン内およびレッスン終了時(時間)に関連するタスクを熟考する必要があります(まだ書きません!)。
  2. コードデモの作成。 多くの場合、何かをあきらめ、何かを追加する必要があります。 要するに、このプラクティスは当初の計画(平均して数時間)に対して調整を行います。
  3. 次に、テキストとプレゼンテーションのスタイルに取り組みます。 目標ができるだけわかりやすく簡単に説明されている場合、各提案について考える必要があります。 このようなテキストを1つのA4ページに書くのに少なくとも1時間かかりました。 また、各レッスンのテキストの量は平均して3ページ弱です。
  4. レッスンに含まれるタスクを確認し、生徒が完了するのに必要な時間(約1時間)を評価します。
  5. レッスンに写真(スクリーンショット、図)が必要な場合は、平均でさらに1時間です。


したがって、約4ページを作成するには7〜9時間かかりました。 合計23レッスンがある場合、私は専ら160-210時間のレッスンを書く時間を費やしたことがわかります。これは上記の記事の著者(約120時間)の約1.5倍であり、そこにあるテキストの量は明らかにもっと多いです。 正直なところ、私はいつも非常にゆっくり書いていると思っていました。 しかし、違いは励ましの1.5倍に過ぎず、ほぼ正常であると述べています。 他のすべて(文学の研究、一般的な計画、サイトでのクラスの配置)を考慮すると、このコースの作成と「公開」には約250〜300時間かかりました。 7.5(300/40)フルタイム労働週。



もちろん、最初からこのテーマを知っていて、Cで多くのプログラミングの経験があれば、マニュアルは2倍速く書かれることを理解しています。



その記事の著者が1日1時間しか書けないことに驚いた。 多くの場合、単純に「被験者に向かってスイングして運転」するのに1時間かかりました。 おそらく気質の特徴。 だから、職場で座ったら、2〜3時間。 1日1時間は意味がありませんでした。



同様に、私は思考が単に行かない時がありました。 しかし、私はこれを気分とは関連付けず、脳が一定量の情報を消化して処理できるという事実と関連付けます。 ある時点で過負荷になり、休息が必要になります。 おそらく、そのような脳の持久力は、物理的な持久力としても訓練されます。



また、その記事の著者が指摘した完璧主義についても言及したいと思います。 はい、高品質のよく考えられた「製品」を作成するという観点からの魅力にもかかわらず、全体を見て、その精神的資源を時間内に分配することを妨げる可能性があります。 完璧さへの欲求は、私がすべてのささいなことを見るために、記述された主題に非常によく気づき始めた時に生じました。 この完璧主義はわずかな幸福感をもたらし、私はさらに良くしたいと思います。 スポーツ、ダンスなどに携わる人々でも、すべての筋肉を感じ、すべての動きを制御しているという喜びを説明すると、同じことが起こります。 しかし、ある時点で、「統合失調症はなくなった」と考えるようになります。



その記事の著者は、何らかの方法でWindowsを普及させる本を書いたので、その本は著者よりもMicrosoftにとって有益です(彼は料金が小さいと書いています)。 まあ、あなたがとても若いかどうか、最初に自分自身を見せて証明したいのかどうかはわかりません。 私はすでにこれに合格しているので、この場合、ヒキガエルは私を絞め殺すでしょう。



私は通常、サイトに自分の文章を投稿します。 しかし、落ちないように、コースのpdfバージョンはYandexからのものです。



All Articles