For an example, look at the "Specifying Colors" under GitHub and on RubyDoc - the {include:file} directive goes away on the RubyDoc, so it is being processed. Googling around it looks like some files might be cleaned out, but I thought my yardopts file includes the samples directory.