Hmm... I have to say that I noticed that the LV2 documentation has improved alot recently, but when I first started programming LV2, I found it very much confusing.  A lot of confusion stemmed from the fact that the connection between the "LV2 Specification" document, and what you actually had to do to make a plugin wasn't clear.  Now the website is better at directing you to "This is how you start" sort of documents, rather than "lv2:portspecification a lv2:urlProperty" sort of stuff.  Because when I looked at those documents, I had no idea what they were talking about, or how to use any of the information they presented.  I wanted to shout out show me the code!  And the only link to the actual C header was a small and seemingly insignificant link, saying "you might also want to look at this".  Anyway, this rant is kind of useless, because the website is much improved, at least from my perspective, although it may just be that now I understand what it's talking about after learning through examples.

Jeremy