Keep in mind that native modules coded against NAN1 do not work with NAN2. Not sure about forward compatibility of NAN.
Edit: I don't mean to say the project sucks - docs sucking is just a general open source problem I can't really blame the authors for.