Yes, this is so important and yet so often not considered. This README was pretty good, thorough and not ambiguous. The number of projects that assume you know what their obscure idea relates to is huge, mainly as the authors can't put themselves in the shoes of their audience.