ホソカワです。
多分、だれかが決めればいいことなので私が決めました。以下の形式で書きましょう。
----------
=== Page xx // xxは、ページ番号です。どのページか明記しましょう。
流れの説明 // 下記のコードをなぜ書いたかの記述。上手さんのまと
// めが主だと思います。
<Smalltalk> // Smalltalk コード関連のスタート
=== Page xx Code yy // ページ番号とそのページの何番目のコードかを明記す
// る。コードだけひとり歩きすると思うので。
Smalltalkコード
Smalltalkコードの解説
</Smalltalk> // Smalltalk コード関連の終わり
<Java> // Java コード関連のスタート
=== Page xx Code yy // ページ番号とそのペジの何番目のコードかを明記す
// る。コードだけひとり歩きすると思うので。
Javaコード
Javaコードの解説
</Java> // Java コード関連の終わり
----------
コメントなどは、行頭に >> がつく場合が多いので、この程度でいいかなと思います。
見にくくなったら考えましょう。
--
Kaoru Hosokawa
khosokawa@....com