Docs: clarification about page title

[antgel]

I had to dig into the source code to find out why my page links weren't automagically generated - this patch will help others in the same boat.

[ashmaroli]

IMO, instead of adding it here, it'd be better next to _includes - header.html with the following edit:

- By default (unlike posts), page FrontMatter requires a `title` attribute, in order for a link to the page to
- be generated (in `header.html`).
+ Displays a list of Pages with `title` set in the FrontMatter

[antgel]

I see where you're coming from, but that doesn't address part of the underlying issue, that no title in Page FrontMatter, leads to... nothing, whereas with a Post, no title DWIM. Do you think your version is explicit enough that it's clear that no Page title => no output?

[ashmaroli]

Do you think your version is explicit enough that it's clear that no Page title => no output?

Perhaps.. perhaps not.
I'm open for further edits. But, I recommend that it be a short n simple sentence.

The trouble with

By default (unlike posts), page FrontMatter requires a `title` attribute, in order for a link to
the page to be generated (in `header.html`).

is that it doesn't convey the essence in a simple manner. I'll break it out to illustrate.

---

By default is used for configurable items. For example,

By default the color is red. But you can override it by defining the '$accentColor' variable

---

(unlke posts) =>

posts or any other collection items have no say here..in the header.html. Its just Pages and Pages alone. Unnecessary confusion.

(in header.html) =>
won't be necessary if the note is included in the right place

[antgel]

@ashmaroli Thanks for the feedback, commit amended to suit, let me know what you think.

[ashmaroli]

LGTM now.

/cc @DirtyF
Should we also make a note about header_links configuration (under Usage) as part of this PR? 🤔

[DirtyF]

Thank you @antgel for the edit! 😄 🔗 💥

[benbalter]

@jekyllbot: merge +docs

Thanks @antgel!