Posted by drinkypoo on August 10, 2009 at 2:33am
Jump to:
| Project: | Voting API |
| Version: | 6.x-2.2 |
| Component: | Documentation |
| Category: | support request |
| Priority: | normal |
| Assigned: | Unassigned |
| Status: | active |
Issue Summary
Sorry, I am not a big-time programmer, I just want to know how to just set a vote. Reading API.txt is too complicated for me, I don't understand what I'm seeing there. I just need a code sample of how I would set a vote on a node, eliminating all other votes. Please help. Why so little documentation? Why no handbook?
Comments
#1
The above quoted from the project page.
#2
The above is a pathetically inadequate quote from the project page. All of those voting systems are SYSTEMS, they are implementations, I have to understand THEIR code before I can understand the voting API? That is a patently ridiculous answer. APIs without documentation should never be used.
If I can't understand the API, how will I understand those modules?
Not having documentation is amateur hour. Not having comments in the code is patently offensive. There's not even comments to tell you which function does what. Being told to go look at the uncommented code is triply offensive, and I would appreciate it if you would save your apologia for some case in which it will be useful, like never.
#3
Go ahead and set this one to fixed too, but it won't change the fact that I haven't been helped, and documentation is NEEDED. Another module's code is NOT documentation! Period, THE END. It makes more sense for me to implement a simple rating widget! It will probably take less time than actually understanding fivestar so that I can understand votingapi.