As I'm currently writing the documentation for Rococoa (http://rococoa.dev.java.net) I'm having to ask myself similar sorts of questions about my docs.

My whistle-stop tour (http://rococoa.dev.java.net/rococoa-whistlestop.html) is more detailed than "JNA's How To Get Started Using JNA (https://jna.dev.java.net/#getting_started"), hell, it even has a page to itself, which I suppose must mean that I think that more detail is needed for my audience.

However, I have a feeling that it is going to come back and haunt me, by encouraging people to try Rococoa who won't be able to take the next step. Rococoa, and to a greater extend JNA, are not amateur tools. Maybe they could be with significant investment, but the current situation is that any developer using the libraries are going to see their VM blown into small pieces on a regular basis, and they are going to have to work out what they just did that caused it. In both cases developers must understand both Java and another language, and in the case of JNA, a good deal about the platform they are targeting.

So I think I would argue that, unless Timothy et al are going to provide a prohibitive amount of support, there has to be a test to see whether you are a worthy enough hacker to start using JNA. Working out what is going on from the current sketchy docs is that test.

Duncan