I understand your frustation! You ask a simple question and some bother only to tell you to search. The search engine is not the best, and frankly a lot of threads are often dead (need then to do a search in the archives, but that means the info is getting old). I suggest that you do a search for seach and see how often this comes up.
In terms of perks for Diamond I think they are somewhat limited to upgrades for better rooms (including suites), better amenities, breakfast. Occasionaly you may get a basket of something or a bottle. These all seem to depend on location, time of the year, year, status of the hotel management, and mostly good fortune. As Diamond, you will get better treatment but I doudt that it should be the limiting factor in selecting a resort.
Personally, I look at location, time to travel, weather, activities (adults vs kids depending on who goes), airfare... Then I usually hope that my status will get me something!
Good luck!
Edited to correct the recurrent platinum slip.
[This message has been edited by fromYXU (edited 09-05-2003).]