#51 improve readme and registry documentation