better documentation and code cleanup for the github extension