write a more detailed description of Dataset.equals

[bergos]

The description should contain more details about the normalization step.

[awwright]

+1 for this, I'm looking for some elaboration as to what Dataset#equals is supposed to do.

Currently, master branch says

Blank Nodes will be normalized.

But it also notes

The given dataset and its content must be treated as immutable

So what data structure, exactly, is being normalized, if not the input Dataset?

This section should make a normative reference to RDF 1.1 Concepts and Abstract Syntax.

[vhf]

What about comparing canonicalized versions of the datasets?

  equals (other) {
    const thisCanonical = this.toCanonical()
    const otherCanonical = other.toCanonical()
    return otherCanonical.trim() === thisCanonical.trim()
  }

  toCanonical () {
    return canonize.canonizeSync(this.toArray(), { algorithm: 'URDNA2015', native: false })
  }