dbuenzli
Adds further, introductory examples.
Hi Daniel,
This pull request adds more examples to AString. This is part of a pilot programme funded by the OCaml Software Foundation.
Many OCaml libraries have no examples, or perfunctory examples only. This makes it difficult to get started with a library, particularly if it has an elaborate interface. A working example, no matter how small, can help a newcomer get started quickly. One day, it would be nice to have an example for every Opam package.
For now, examples begin in the OCaml Nursery, here: https://github.com/johnwhitington/ocaml-nursery (you can read in the README there about the principles behind these examples.) Then, if package authors agree, they are promoted to upstream source. The hope is that this will mean they are more likely to be kept up to date with the library.
The examples are included in a separate directory, within a separate Dune workspace. And so they are intended to be used after installation of the library.
As well as considering accepting this pull request, please do give any comments you have on this programme.
(The above is boilerplate. Specific notes 1. Since you already have examples, I merged them rather than adding our usual structure. 2. Note change to README.md - does this need changing in your other packages' READMEs too?)
