Add doc to warn about strange behaviour with assets path when using diretory indexes.

Fixes middleman/middleman#818