It's the mystery, undocumented Count().
Isn't it just a little annoying that the Roku docs don't tell the whole picture?
It sure is annoying, to say the least. It is also counter-productive, having to spend time experimenting things that should be able to find with a glance at documentation. Or the cases when they fail to mention there are version issues (i.e. something not supported in fw3) - that is negligence.
I have proposed in the past
, if RokuCo cannot muster the workforce to maintain the docs - then to give access to select few of the outside dev.community, so they can fix obvious mistakes and omissions. Sure it's a touchy subject but if the attitude is "we could do this ourselves", they should as well do it. As @squirreltown put it aptly elsewhere, "This is just embarrassing. Like people who bondo their dents but never paint them. So close to finishing the job and then....Squirrel!"
To the limited extent i could, i try to help - in two steps:
1. When i discover omission/issue in the docs, i post a separate thread on that (so a discussion or explanation may happen) and
2. Link to it in viewtopic.php?f=34&t=69731
, in hopes that some faithful day someone may start going over these and resolving them. (admittedly i have slacked recently on linking there, should catch up)
Sometimes attempts of Roku personnel to help may end up making things worse though. There is a case that still bothers me but i just couldn't figure mentioning it without being complete arse. Because the person who did the edit i am sure had good intent and probably acted to the best of their abilities but... their "fix" made things worse than they were. I was asking about ifGetMessagePort/ifSetMessagePort of roCaptionRenderer
- why they were not returned by getInterface
. And then someone apparently decided "solution" to that was to just delete ifGetMessagePort/ifSetMessagePort from the page. It feels as if i called the city water district to report a water mains leak and their solution ended being to turn off the water supply for the neighborhood... permanently. Doh.
PS. First step to fixing a problem is admitting there is a problem - but i don't know if even internally RokuCo admits there is one.