プログラムドキュメント作成の難しさ

MCAP-CR型多自由度を含むバスレフ型の力学シミュレータプログラムは、一昨年に完成し、昨年公開しました。
そろそろ次の機能向上を考えていますが、その前に、これはこれで一つの完成形として、ドキュメントを作成しています。
プログラムは、作ったそのときは分かるのですが時間が経つと内容を追うことが難しくなり、ましてや他人が読むのは困難です。
本職のプログラマであれば、おそらくコメントだけで内容が分かるようように作れるのですが、自分のような素人のプログラムは、追っていくのが難しいと思います。
また、内容は、科学技術あるいは工学計算プログラムなので、厳密性が必要です。
そこで、最初に、サブルーチンの一覧と変数の一覧、主要な計算の一覧を作成したまでは良かったのですが..

これだけでは自分も分からないので、フローチャートを書いてみました。
すると、フローチャートが複雑になって余計に良く分かりません。
分岐ブロックが増え、同じことをあちこちに書かなければなりません。
計算オプションを分け、処理を微妙に変えてもその中には共通の処理も多くあります。

書いてみると、正直言って複雑過ぎます。
通常のフローチャート図式を使わずに、自分の書式で作ったほうがいいのかもしれません。
そういえば、フローチャートの記号も複数あるようで、これを使えば絶対、という定型はなさそうに見えます。
皆さん同じように悩んだのでしょうか。
挫折が多過ぎます。

ちょっと頭を冷やして考えてみます。