code: private void resolve(LinkRelation rel) {
      Iterator<LinkRelationRef> refs = rel.getLinkRelationRefs().iterator();
      while (refs.hasNext()) {
        LinkRelationRef ref = refs.next();
        LinkRelation referencedRel = linkRelations.stream()
            .filter(item -> StringUtils.equals(item.getRel(), ref.getRel()))
            .findFirst().orElse(null);
        if (referencedRel == null) {
          refs.remove();
        }
        else {
          if (StringUtils.isBlank(ref.getShortDescription())) {
            ref.setShortDescription(referencedRel.getShortDescription());
          }
        }
      }
    }
docs: Iterates over nested link relations. If they are valid filename is set and decription inherited (if empty).
  Invalid ones are removed.
  @param rel Link relations