Maybe here for top level objects we could have a comment describing the scope of the object. For example for entity we could have : 

    /**
     * All translations linked to generic mayocat entities
     */
    entity : {
      // etc.