Added explanation about why sorting the sitemap can be useful

2020-02-26 14:05:35 +00:00 · 2020-02-26 14:05:35 +00:00 · bf823cf48b
parent ed415b0f10
commit bf823cf48b
1 changed files with 5 additions and 0 deletions
--- a/content/docs/guides/sitemap/contents.lr
+++ b/content/docs/guides/sitemap/contents.lr
@ -43,6 +43,11 @@ skips hidden pages so those will not be generated out.
 </urlset>
 ```

+Sorting the page using `|sort(attribute='path')` is not mandatory, but can be
+useful if you prefer to have stable builds, for instance if you use `git` to
+version the generated page and would like a clean history or a meaningful diff
+from the last build.
+
 Note that because sitemaps need to have external URLs (with scheme and
 everything) you will need to configure the `url` of the site before the
 template starts working.  For more information see [Project File