better documentation for how to parse