膨らみすぎて手が付けられないコードの管理方針を考えてみた

皆様,こんにちは.

もう今年の残りが一年の24分の1程度しかないことに先ほど気づいたところであります.

年末と言えば,大掃除.

私は片付けが苦手すぎて服とか本とか捨てられずに困っているのですが,パソコンの中も同じです.

3年近く同じ環境で引き継ぎもなくコードを書き溜めていたので,収拾がつかなくなってきました.

これはまずい.

いろいろ苦労しながら書いたコードも,どこにあるか探せなくなってしまっては宝の持ち腐れです.

というわけでこれからコードをまともに管理できるようにするために,

現状分析と指針を箇条書きでまとめてみました.

「もっといい方法があるのに」とか「こういう管理方法があるよ」とか,

「それはないわーww」でもいいので突っ込みお待ちしております.

======

何の為にコード管理をするのか?

  • 効率の良い開発のため
    • 新規の処理の追加
    • バグ取り
  • 効率の良い引き継ぎのため
    • 機能単位の把握
    • 必要なファイルだけ着目できる(不要な/非本質的なコードの除外/不可視化)
  • 効率の良いバックアップのため
    • 変更履歴の追跡
    • 漏れのないバックアップ

現状はどうしているのか?

  • スクリプトはnote(yymmdd)_(script_name).m
  • 関数はfnote(yymmdd)_(function_name).m
  • matlab/code ディレクトリにまとめて配置
  • 最近Gitを導入した

どのような問題があるのか?

  • 古いコードが多すぎて,どれが使えるのかよくわからない
  • Gitの管理単位が大きすぎて(Codeディレクトリすべて)変更を追いにくい
  • ファイル名は確実にユニークだが機能ベースでの検索に向いていない

解決方策

  1. プロジェクト単位でディレクトリを分ける
    • プロジェクトの中だけパスを通せばいいようにする
      • 逆に他のプロジェクトと相互依存しないようにする
      • 関係のないプロジェクトはパスから外す
      • 違うプロジェクトと同じ名前の関数があってもぶつからなくなる
      • 同じ機能の改良版なども比較的容易に作れるし扱える
    • 何をしているのかわかりやすい
      • ドキュメントもプロジェクト単位で作成すればよい
  2. Gitをもっと使いこなす
    • 卒論サーバーにでもリポジトリを作る
      • 本体が壊れても大丈夫
    • プロジェクト単位でGitのリポジトリを作成
      • 同名ファイルの重複が避けられる
  3. ファイル名のルールを変更する
    • 機能だけちゃんとあらわしている名前を付ける
      • ファイル名の一意性が必要ない
    • プリフィクスなどもつけない(関数に”f”など)
      • 基本的に関数ベースにする
  4. 開発方針の変更
    • 機能単位の分割(カプセル化)
      • 本文の長いコードは読みにくい
      • できるだけこまめに分割し,コメントだけでなく名前で機能を語らせる
      • 基本的に関数ベースにする,テスト以外はスクリプトを使わない

初めての結婚式披露宴のご招待に,右往左往しながら準備をした備忘録

お久しぶりです.

ずいぶん間が空いた上に技術のネタですらない個人的な話で恐縮です.

今回初めて結婚式の披露宴にご招待いただきました,

サークルで非常にかわいがっていただいた先輩方なのでうれしい限りですが,

今までは結婚式は呼ばれても2次会から,とりあえずスーツで行けばOK,という感じだったので

どんな格好で行けばいいのか何を持って行けばいいのかよくわかりませんでした.

そもそも招待状には会費とか載ってないんですよね(ご祝儀を持って行くから)

それでいろいろ調べていたので思い出しながらまとめてみることにします.

1.Google先生に「結婚式 披露宴 服装」について教えを請う

都合のいいことに,服装だけでなくマナーについて一通りまとめてくださっているサイトを見つけました.

結婚式のマナー/結婚式の招待状・ご祝儀・服装 http://www.happy2-marriage.com/

これを一通り読んでみたら,結構わかってないことが多いことがわかりました.

2.服装

まずスーツ屋に行って披露宴でつけられるようなネクタイを探しています,と聞いてみました.

灰色というかシルバーのネクタイをお勧めされて,ついでにポケットチーフも買いました.

白いネクタイというのはご親族の方とかが多いのですね.

3.ご祝儀

中身は新札なので銀行で両替をしました.

銀行の方に聞いたら,両替機に新札が入ってるんですね.

ご祝儀袋も用意したのですが,短冊が3枚入っていて,使い方に困りました.

Google先生に「ご祝儀袋 短冊」とか聞いても一枚だけ挟むとか白紙の短冊と合わせて二枚で挟むとか諸説あるようです.

祝儀袋の短冊の使い方 | OKWave http://okwave.jp/qa/q5488596.html

むー.

あと,筆ペンで自分の名前と住所と金額を書かないといけないのが意外としんどいですね.

普段パソコンばかりでボールペンすらろくに持たないもので...

あとは,ご祝儀袋を入れる「袱紗(ふくさ)」というのも買いました.

あとは当日遅刻なんかしないように頑張って起きるくらいでしょうか.