Add doc to warn about strange behaviour with assets path when using directory indexes.
Fixes middleman/middleman#818
Merge pull request #230 from michaelbaudino/document-directory-indexes-relative-assets-path-bug

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