Hey thanks for the feedback, I am rewriting the whole documentation at the moment to make it easier to understand and cover v2 of Holesail that we recently released.
If you have a particular question about it, I am happy to help.
Yes it does, we have a Node API atm, but if someone wants to integrate directly as a Minecraft plugin then they would need to write Java bindings for Barejs.