rename "include" to "default" or something else.

[jonschlinkert]

So that the include mixin allows you to include content from any file in any directory.

[dylang]

I agree. I spent an hour trying to figure out why my new template wouldn't work.

Another idea is for include to default to the user directory, and fall back to the built-in templates when a file isn't found. This way we can override just the ones we want to change.

[jonschlinkert]

Agreed, something needs to change. For the time being, if you use ,<%= _.doc("foo.md") %>, grunt-readme will look for the file in your local ./docs folder. You should be able to override this in the task options:

readme: {
  options: {
    docs: './foo/bar'
  }
}

[jonschlinkert]

I know that doesn't resolve this, just thought it might help in the meantime