Remove confusion in docs

[coolshaurya]

fixes issue 268 in 11ty/eleventy

[kleinfreund]

Hey. Hm, I’m not too happy with either the current version or your proposed version.

First of all, the includes directory is not meant for data in general. That purpose is served by data files which are a different concept.

What do you think about the following?

- Controls the directory inside which the template includes/extends/partials/etc can be found.
+ Controls the directory inside which the templates, extends, partials or other includes can be found.

(For reference, the discussion around this started in 11ty/eleventy#268.)

[edwardhorsford]

I'm not sure it is meant for 'data in general'. Is it?

[coolshaurya]

No, it is not.
What I meant was template data in general. I wrote it in a hurry.

[zachleat]

Controls which directory is the includes directory. The includes directory is meant for templates, extends, partials or other includes like macros and brand assets.

I think we can get rid of this line, seems redundant?

Controls which directory is the includes directory.

I like what you’re going for here, I wonder if it would be better like this?

The includes directory is meant for templates include files, extends files, partials, or macros. These files will not be processed as Eleventy templates, but can be consumed by other templates.

[coolshaurya]

@zachleat ,We can certainly get rid of that line.

Removing 'templates' form that line can still cause confusion as layout templates are stored in the includes directory too.

[zachleat]

How are you defining a template? To me a template is any string using template syntax—it could be content, an include, macro, partial, layout, anything.

To say something is a template doesn’t really give any extra context about what that thing is?

[zachleat]

See also #24

[coolshaurya]

What about this -

The includes directory is meant for layout templates, include files, extends files, partials, or macros. These files will not be processed as input files, but can be consumed by other templates.

[zachleat]

Yes I like that a lot @coolshaurya!

[coolshaurya]

Done - changes committed

[zachleat]

Shipped! Thanks for iterating on this!