docs: updates to documentation, removing dependency on json schema lib