tweak jsdoc

client/src/machine/DataView.ts

@@ -2,9 +2,7 @@ import {LogicalLine} from "./api.ts";
 
 /**
  * Representation of a generic view of data, a vertical sequence of horizontal string of kv pairs.
- * A generic displayable structure with a sequence of entries. Each entry is a sequence of
- * string tuples. The string tuple represents a name-value pair that will be rendered with
- * the name as a className and the value as the text content of a span element.
+ * A generic displayable structure with a sequence of {@link LogicalLine LogicalLines}.
  */
 interface DataView {
   getLines(): LogicalLine[];

client/src/machine/api.ts

@@ -8,6 +8,8 @@ import {Memory} from "./Memory.ts";
 
 /**
  * Renderable output of structured text with html-friendly structure and internal text renderer.
+ * A sequence of string tuples that represent a name-value pair that will be rendered with
+ * the name as a className and the value as the text content of a span element.
  */
 class Tag {
 
@@ -76,6 +78,7 @@ class LogicalLine {
 
   /**
    * Temporary transition encapsulation
+   *
    * TODO: use an abstraction that more closely models the domain, tags carry too much responsibility
    */
   private readonly tags: Tag[];