Correcting errors and updating readme

Created by: alix-tz

The typo in list_keys was leading the script to error ;

Adding the deletion of ' in xml:id values seems necessary ;

Updating documentation seemed to become urgent