I agree with all of the above. It's difficult to see how useful this is among the deep technical explanation. The chart on the github page emphasizes features of DNSChain that the current system lacks, but perhaps a chart showing where the current system fails and where this fixes those issues would be more useful?
> The solution is to just not explain how it works, the public doesn't need to understand how it works to use it and to trust it.
Who is "public"? People with technical background or without technical background?
Let's first restrict our scope to people with technical background and assume people already have a degree of understanding on how blockchain is used. Then if a developer tells you the README doesn't convey the message clearly, take note of that and appreciate the feedback. Don't say "just trust me it works."
If this is to the general public, you better hire someone who can actually explain to user how it works from a high level giving analogy is always good.
In fact, you should never assume there are two groups of audience. This is not writing API documentation. A README should be really clear to user how to get started (understand what it does and how to start using it). Think about working with a manual. You can't assume everyone know what certain nail is called by nickname. You need to write the actual name with an actual picture. Don't assume. Be general.
"Trust me it works and it's secure" is the worst thing you can sell to anyone today. Of course I will never know how Dropbox handles my files on their server securely, but at least I can understand when my file is transferred over HTTPS it's encrypted in the communication and when they say they are over the cloud I know I can access it anywhere at anytime as long as I have an Internet access and the data center still exist.
And if I don't understand what the software does how can I trust you to deploy this on my own term? How do I even begin debugging problem during installation or configuring my service?
"Trust me" is not an option, especially when someone is trying to get people to use a software. The one thing we need to change is to teach people enough computer so they can make a judgement whether they should trust something or not ("trust me this photo tool is awesome and is free ... minus the free ad program install alongside with it) or trust me this version of browser is nice come to https://evil.com instead of https://mozilla or chrome
Perhaps we can learn from PGP adoption and evangelism. One reason why it's not widespread is it simply doesn't "just work" in the minds of a non-technical end user. Sure there are longer, detailed causes to debate over but that is the bottom line to a non-technical end user.
If people who advocated for the web explained the entire networking stack every time they tried to get people to use it they'd miss how it helps them.