Reorganized the main Catmandu.pm documentation and added some up-to-date
examples