Improve documentation on joint data references

[karldd]

As mentioned in #90 we need to provide better documentation about how the joint data references other stuff. Namely:

• References from json graph to entities
• References from json graph nodes to links