Distinguish between documents

[yehudarav]

In the current version, the type of the document is the header that distinguish between different documents.

However, the type is not a good way to discriminate between documents. It is primarly used to query the documents and hence, has a tendency to have the same value.

The main differences between the nodes are the values in the desc property. However, it is very difficult to see it, as it could be arbitrary structure
with different values in different nodes. Hence, we have developed a utility called JSON compare (see utils.jsonutils).
This gets a list of JSONS and returns a pandas table with the differences (the names of the keys are flattened to _)
So the two JSONS :
file 1

{
 "a" : 1
 "b" : { 
       "a" : "x"
   }
}

and file 2

{
 "a" : 1
 "b" : { 
       "a" : "Y"
   }
}

Will be:

	file1	file 2
b__a	X	Y

Hence, the document type could be the name of a tree node that is expandable. Once expanded, I think a better way to show documents would be a table that highlights the differences in the descriptions (similar to the JSON compare utility we built).

[erasta]

Hence, we have developed a utility called JSON compare (see utils.jsonutils)

Note:
There is a standard called json patch (wiki)
It has multiple implementations in most common languages (also js and python)
Some samples and implementation references: https://jsonpatch.com/

[erasta]

Hence, the document type could be the name of a tree node that is expandable. Once expanded, I think a better way to show documents would be a table that highlights the differences in the descriptions (similar to the JSON compare utility we built).

This is a good way to compare or highlight documents, but a document type is usually something compact, where multiple differences could lead to a too verbose display if shown on a list.
Maybe you want this ability on a different location than on the list?

[erasta]

Another note:
Compare the document of the tree node to which other document? a specific one? a base one? all of them?
Please advise @yehudarav