yes that must be it. suppose reading
Better documentation or
Beginner friendly documentation
we might have a go at making this a bit less ambiguous 
@frenck, please forgive the tag, but would this require an edit on the current documentation taking out the word ‘Required’, or is it a bug, requiring an issue in the repo Core.