Magicで作成したシステムの設計書

お世話になります。
先輩諸氏に質問です。
Magicで作成したPGのドキュメントはどのような書式で
作成しておられるのでしょうか。

通常のPG言語であれば，処理に重きを置いた記法が使えるのですが，
仕様はともかく，実装を的確に示すドキュメントの書式が
今一つ思い浮かびません。
私の感想ではフローからデータビュー，ロジック，フォーム各ビューへの
落とし込みが難しいように思います。
特に，
　　　1.各数式が番号で管理されていること。
　　　2.変数が英字2文字で表示されていること。
がネックに感じております。

せめて，式の中にコメントが打てればとは思うのですが……。
皆様のご意見・ご存知の手法がございましたらご教授いただきたく。

wshoichiさん、こんにちは。

Magicは製品のコンセプトからして、SEが設計を行ってプログラマ
がプログラムを記述するという言語ではないようです。

どちらかというと、SEがフレーム記述方式で設計を行うと、それが
そのままプロトタイプとして動作するというRADツールです。

ですので、紙による仕様書の手法はあまり用いられないと思います。

ただ、業務上、紙媒体による設計書が必須という環境もあるかと
思いますので、何らかの回避策は必要かもしれませんね。

Tanda様，こんにちは。
いつもありがとうございます。
　実はあるシステムを引き継いだのですが，お恥ずかしながら，
仕様書もない状況でして，現状の整理からと思い質問させて
いただきました。

　おっしゃる通りのコンセプトであれば，仕様書自体の記法は
特に無いということですね。

　システム自体の変更が容易なゆえに，仕様の管理をより厳密に
行う必要があると感じました。

　　どのような開発手法・言語でも言えることですが，
仕様を適切にメンテナンスするのが一番の近道ですね。

wshoichiさん、こんにちは。

ご指摘の定義式番号とカラムのシンボル名なんですが、ご存知だと
思いますが、これらは行の挿入を行うことによって、動的に変化します。

したがいまして、これらを仕様書として定義しようとしますと、途中の
行には挿入を行わずに、すべてを末尾に追加するという方法が考えられ
るのですが、定義式のほうはそれでもいいとしまして、シンボル名の
ほうは子タスク、孫タスクと下りますと、ルートタスクのデータビューの
長さに応じて可変となってしまいます（これがMagicの良いところでも
あるのですが）。

ですので、仕様のドキュメンテーションにあたりましては、前後関係で
動的に変化するMagicの記号、番号等は記載されないほうがよろしいか
と思います。

それ以外は通常に仕様定義でよろしいかと思います。

Tanda様，こんにちは。

　ですね。定義式番号・シンボル名で管理しようとすると，
破綻します。
定義式番号・シンボル名で管理するのではなく，
定義式の意味と，シンボル名の意味で管理するように
しています。
　初心者なりに使用してみて思うのですが，表示関連は抜群に
効率が良いですね。
　作成・変更が容易なのでついついドキュメンテーションを
さぼってしまいそうになります。
　PG経験のない方でも容易に作成できるというのがウリに
なっていますので，初学者のセミナーではドキュメントの
重要性について説明する機会があってもよいかもしれませんね。

Magic Optimizerを確認してみて下さい。
ドキュメントが出力できます。

違っていたらすみません

ISHIJIMA様，こんにちは。
早速評価版をダウンロードし，評価してみます。
ありがとうございました。