Again, at one point you have to assume either basic knowledge or at least basic knowledge about how to search for things, otherwise everything would be very ver

Again, at one point you have to assume either basic knowledge or at least basic knowledge about how to search for things, otherwise everything would be very verbose. Take one of your repositories as an example: https://github.com/timraymond/pricegrabber https://github.com/timraymond/pricegrabber > A gem for interacting with the Pricegrabber API Should you have to add "Application Programming Interface (API)" the first time you use "API" anywhere? Realistically no, because the audience can be assumed to understand what it means. If they don't, it's only a search away. Same goes for networking and DNS/BGP/CNAME and more. If you're using a library/server for BGP, you either know what those terms are, or know how to find out more. But not all resources are meant for beginning who don't know the basic terms in a field, and that's OK, because otherwise everything would be extremely verbose when it doesn't have to.