Comment by pstuart
1 month ago
Agreed, but IMHO it should be layered so one can enter at the highest conceptual level and drill down and back up so there's a continuous flow of understanding.
1 month ago
Agreed, but IMHO it should be layered so one can enter at the highest conceptual level and drill down and back up so there's a continuous flow of understanding.
My experience is that if there's too much documentation for a given representation, a not insignificant number of folks will not read it --- divide and conquer seems to be a workable approach.
I agree -- my point was to have the details linked in a drill down manner so that one can skim the high level parts but easily expand upon any topic directly from where it's being referenced.
I would like to see a UI/toolkit which implements that easily and works well.