new document 2019 link is here .
some different from old document ( that removed from github)
some properties , why required ? old feed document wrote that optional .
I test new 2019 version feed with no those properties , it passed preview feed validation! .
Hope admin rewrite document for anyone in future. thank you all.
I've already written to Roku Partner Success about a previous problem with the Json Spec document. They corrected it in about a week.
I agree with your concerns and have requested the Partner Success review your concerns as they do seem valid. I'll reply when I hear back.
Roku Partner Success has indicated that some of the documentation issues have been addressed. Their initial reply:
Finally getting back to you. I apologize for the wait time! Answer to question 2.: Captions required only for content that has been broadcast in the USA, but this is required by the US Government not Roku. Trick Play files, nice to have, we don't require those yet, and Ad Breaks are if you have midroll ads and want to control when they appear so you don't arbitrarily interrupt content. Let me know if you have any additional questions!
I indicated to them that the reply was incomplete because they had not explained the changed requirement for Captions, Trick Play and Ad Breaks. They replied:
Thank you for following up because your clarification helped us pinpoint the missing information. Our writer has added the enum values back in, you should see the change in roughly 5 minutes. No, these are not required at the moment, except in the instances I mentioned. I will see about getting this section clarified as well. Thanks, again, for pointing these issues out as missed or incorrect items. You are helping make our docs better.
Admittedly, this is not an entirely clear response from them. Hopefully, they will clean up the documentation further to remove the confusion.
Be advised. I have found more problems with the JSON spec document and have reported them to Roku. One of the problems involves the renaming of a feed file field. I don't know if that will break existing feed files.