update documentations and fixes the url of the markdown