That comment about skipping the theme dirs - was because we want to support loading the documentation comment from the existing core template - but the overridden theme version should display as the example. We shouldn't be required to always duplicate the comments when overriding a template.
General developer forum
Developer meeting April 2015
This discussion has been locked so you can no longer reply to it.