improved documentation and link to contrib guidelines