improved README and docs, external links and script to sync both