Graph Magic Todo List
Feel free to send in suggestions for other items.
Clues and implementation code are also quite welcome, of course...
Although these INCLUDEs do a nice job of making TWiki pages
conform to the DRY (Don't Repeat Yourself) precept,
the code itself could clearly use some refactoring.
However, this shouldn't be attempted until the code stabilizes.
There are a few situations (eg, a node with no views)
that cause the TWiki markup to get mangled.
Some of this can be handled by making fields Mandatory.
The checking in the gm2doc script should also be improved.
In order to allow interactive control of form visibility,
we had to edit the primary view template in twiki/templates.
It will be possible to control this on a web-specific basis
as soon as we move to the current (4.2.2) TWiki release.
We need some detailed HowTo pages for Graph Magic tasks
(eg, use, editing, and administration).
Some of the TWiki markup lines are much longer than we'd like,
but we couldn't make them work when folded.
If a page does not exist, it will not show up in an index.
It might be useful to display pages which are listed
in the NodeNames and EdgeNames pages, but not yet created.
The "All A's of This B" INCLUDEs show related pages quite nicely,
listing them in title order, providing links and precis text,
showing some indirect (ie, second-level) relationships, etc.
Unfortunately, the second-level items do not fare so well.
They are listed in name order and do not act as links. Tsk...
This wiki page is maintained by Rich Morin
an independent consultant specializing in software design, development, and documentation.
Please feel free to email
comments, inquiries, suggestions, etc!