Agreed.
And I also agree that interpreting some documentation needs nous; but for the libraries in question it's pretty good as long as you have a good grounding in Lua and Lua libraries, and understand the structure of the documentation, and that a readme file is probably all the documentation. (We're in open source land, after all)
If you haven't all of the above yes, it takes some learning if you aren't willing to simply follow trusted advice.
All of us 'super-users' started off following trusted advice for what seemed like magic, and only later going beyond the confines of see-this-do-this.
These are 'standard' libraries made available for FH plugin coders.only a small subset of that subset would go beyond the standard libraries
Ron wants to see/understand the code of any library he uses, rather than trust advice -- fair enough, but it means he probably won't use any library to make his life easier -- fine, but I don't think he should expect anyone to help him debug code that provides functionality which is available in a library. I appreciate that he wasn't originally asking for such advice but I was hoping I could help him to simplify his code. Never again.