Documentation + Tutorial

[neunenak]

Please add a documentation page explaining what parsing functionality exists within this library.

A basic tutorial about how to get started writing a simple-but-complete parser from scratch would also be helpful.

[fgdorais]

Any ideas what the tutorial parser should be?

[neunenak]

Any ideas what the tutorial parser should be?

Writing up how you went about writing the JSON parser would make for a reasonably simple tutorial example, I think.

In addition to that, I also think it would be good to have a very short, very simple parser - something that can be fully explained in a few paragraphs. This could be something as simple as parsing lists of integers separated by newlines out of a text file.

[fgdorais]

Progress on this issue has been slow but it is happening. A very basic but nontrivial parser example was added to the README in #64. The JSON validator example was updated with considerable annotations in #65. This is not quite tutorial level yet but it's much better, I think. There is more to come...