docs: change named anchors to spans with ids
docs: update info on valid JSON