Best strategy for documenting TiddlyMap links/edges?

[Antony Hilliard]

Hello TiddlyWiki community,

First off, thank you to all the contributors and to Felix for TiddlyMap. What a great platform for developing knowledge bases!  I'm trying to figure out how to develop typical industrial engineering task and work analyses in TiddlyWiki, most likely with the TiddlyMap plugin.  (e.g. https://github.com/ahilliard/tiddlyWDA )

Documenting edge-types is very well supported ( http://tiddlymap.org/#Edge%20types ).  But what approach have others found best for documenting specific instances of TiddlyMap edges? The use case is showing a draft analysis/wiki to an expert to ask for corrections/critiques. This means it should be easy for a reader to understand what is meant by each node/edge in the Tiddlymap.

Some options that have come to mind:

1. Manually document each edge in the description in the origin and/or destination nodes.  Works, but not very elegant especially when drafting and moving edges around.
   
2. Not document each edge, leave it implicit and hope that the edge-type description is enough for readers ( not ideal since the whole purpose is to support debating/validating the links )
3. Try to figure out how to link WikiText to the TiddlyMap auto-generated Edge IDs ( http://tiddlymap.org/#Storage%20of%20Edges%20and%20their%20types ).  
   

How have others solved this issue?

-Antony

[TonyM]

Antony,

I am not a big user of tiddlymap yet. But to get you started on my reading the edges are recorded in a json data tiddler. Such a tiddler should be accessible as with any other data tiddler using the index and ## notation.

As long as you add a prefix it should be trivial to make an independent tiddler for each edge on which to allow comments, using a batch button.

Regards

Tony