Recently I was viewing issues/pull requests lists and I spotted that a lot of tickets have been/are caused because people doesn't know how to use some function/class. I was thinking that maybe it would be worth to show unit tests sources somewhere on website? For example by a link on class' reference pages.
Second thing is something that I've done myself - tried to instantiate an abstract class(not because I wasn't aware that it's impossible with PHP) because reference doesn't indicate is class an abstract(example: http://docs.phalcon.io/en/latest/api/Phalcon_Forms_Element.html). Maybe it would be worth to add 'abstract' prefix to abstract classes listed below the docs?
I would like to know your thoughts.