final cleanup and review for default + github md