Why does Open Source software lack documentation?
I think I have found the answer, noone reads it anyway, if you look at the TinyMCE forum, 75%-90% of the questions have direct answers in the documentation (or even the FAQ), and the replies to it is simple “check the documentation” followed by a “brilliant, thanks!”.
In my opinion, TinyMCE is quite well documented, thanks to ppl helping out and keeping it up to date and free of typos. It has taken a lot of time to make this documentation good, and it feels kinda sad that ppl do not take the time to read it.
Everyone does not have the same way of thinking, but at least when it comes down to solving an issue with a 3rd party software, these are the simple steps I follow.
- Check the documentation to the product, the readme, install.txt, wiki etc.
- Try a few different Google querys to find out if someone else has had the same problem.
- Search in forums/mailinglists etc for a solution.
- Try to contact someone or post in public forum/mailinglist etc.
Seems like a lot of ppl just skip to step #4 right away.
Well I guess it is better to have than not to have in the end, hopefully some ppl developing more advanced integrations get a lot of help from the API documentation etc.