最近Java書いててjavadocが状態遷移を表すのに使えないことを知った。
いやjavadocどういうものか知ってたけど、
あまりがっちりAPIのドキュメントとか書きたくない書いたことないから
javadocで適当に説明だけ書いとけばいいやなノリで書いてて、
最初に「フロー説明しろ」って言われて詰んだ。
まぁまずそれですよね。何しろまだあまり仕事でコード書いたことないので...
とりあえずmain()だけ見せてお茶を濁したりした。
ようするに詳細定義のドキュメントを書いたことがない幸せ者だったってだけの話です。オチはない。