@contents does not respect the order of pages passed to makedocs

[tkf]

In https://tkf.github.io/julia-python-snippets/dev/, I noticed that the order of pages specified in make.jl is reflected only to the sidebar:

and not to the table of contents:

generated by:

```@contents
```

Is it possible to fix @contents to respect the order of pages?

The Travis build is using Documenter v0.21.1. I tried using Documenter master 43cb56a locally but the result was the same.

[martinholters]

From a brief look, the order of the entries in @contents (unless explicitly specified with a Pages=... therein) seems inherently undefined, as it depends on the iteration order of a Dict.
I think in

Documenter.jl/src/Documents.jl

Lines 431 to 432 in 95721f0

	# Sorting contents links.
	pagesmap = precedence(contents.pages)

one would need to check whether isempty(contents.pages) (i.e. Pages=... is not given) and then extract the files from document.user.pages (the array given to makedocs) instead. I don't have the bandwidth to work that out and turn it into a PR, so leaving this here for anyone willing to pick it up.

[laborg]

I thought I stumbled over this bug but what I actually missed is the initial upper case of Pages in the @contents block. It would really be good to warn on unexpected (pages instead of Pages) settings!

[mortenpi]

@laborg Do you want to open a separate issue for that?