ariyasacca

▼ [サバティカル][Software]ソフトウェアの文書化、README駆動開発失敗、やる気ゲージ

睡眠と天候

• 前日就寝：03:30
• 当日起床：10:45
• 当日天候：小雪が舞っており寒い

23時台には布団へ入っているのだが寝付きが悪い。寝過ぎなんだろうか。

先週くらいから自分で使うためのソフトウェアを作っている。本体のコードの実装自体は、1日か2日で書き終わってて、「あとはドキュメントをしっかり整えたらバージョン1.0.0にするか～」と思ったまま、この文書化がズルズルと終わらないでいる。ちゃんとしたドキュメント書くのは相当に面倒くさい。

僕自身も当てはまる行為で、ドキュメントがろくに更新されてないソフトウェアに対して「ちゃんと書けや～！」とよく言う人が居るけど、いざ自分でドキュメント書く立場になってみると、その面倒さが身に染みて分かる……。なのでコードの寄稿でなくてドキュメントの充実を手伝う、という貢献方法も、オープンソースの世界では尊い行為なのである。

もともと休暇に入る前にコンセプトだけ書いておいたMOSBurgerというソフトウェア、休暇期間中に仕上げる気満々なのだけど、現時点で全く進んでいなくてREADME駆動開発に完全失敗している感が強い。iOSアプリは開発環境がガンガンと更新される上に、Swiftの言語仕様もしょっちゅう破壊的変更が加わるため、一度でも取り残されてしまうと、なかなか追いかける気力が湧かないのである。

「やる気ゲージは好きなことをしている時しか回復しない」という名言を思い出す。MOSBurgerは、あと10回くらいモスバーガーに行ったら書き始められる気がする。