.NextInSection
pointer to the following content within the same section (based on publishdate field in front matter
.PrevInSection
Pointer to the previous content within the same section (based on publishdate in front matter). For example, {{if .PrevInSection}}{{.PrevInSection.Permalink}}{{end}}.
The above is from the Docs and it’s very clearly stated that PublishDate is taken into account not Weight.
I’m closing this thread. There is no point in discussing the naming of variables that were decided years ago.
No, I don’t mind reopening this topic again, since you request it.
I have seen first hand, that when .PublishDate is missing then .Date is taken into account for .PrevInSection and NextInSection.
If you feel that something is missing from the Docs Pull Requests are welcome.
EDIT
Also I renamed the topic since it’s really about the sorting order of content pages that are rendered with .PrevInSection and NextInSection and not the naming of these variables as it seemed in your first post @ahmet