Fully in agreement with you Eli. To provide agency to potential IndieWeb adopters, it is needed to start from purposes and what things a person wants to achieve. Build a pathway from there, and provide the building blocks. Not start from the tech specs. Myself I am frequently lost in the IndieWeb woods, even if I have some tech knowledge, and am not easily thrown off by the need to hunt down clues in obscure fora for a fix to an issue. Too often too much knowledge is assumed on all things IndieWeb if you seem to have some knowledge about a tiny part of it.