docs: Add docs for append

See #5190

tpl/collections: Add collections.Append

Before this commit you would typically use `.Scratch.Add` to manually create slices in a loop.

With variable overwrite in Go 1.11, we can do better. This commit adds the `append` template func.

A made-up example:

```bash
{{ $p1 := index .Site.RegularPages 0 }}{{ $p2 := index .Site.RegularPages 1 }}
{{ $pages := slice }}
{{ if true }}
  {{ $pages = $pages | append $p2 $p1 }}
{{ end }}
```

Note that with 2 slices as arguments, the two examples below will give the same result:

```bash
{{ $s1 := slice "a" "b" | append (slice "c" "d") }}
{{ $s2 := slice "a" "b" | append "c" "d" }}
```

Both of the above will give `[]string{a, b, c, d}`.

This commit also improves the type handling in the `slice` template function. Now `slice "a" "b"` will give a `[]string` slice. The old behaviour was to return a `[]interface{}`.

Fixes #5190

Merge commit '13e64d72763bf8d6d92d4cdfc15ed45ee9debfab'

Squashed 'docs/' changes from 9b494a58c..6b00298bb

6b00298bb Remove outdated "related example"
987f1e1cd Fix dead links (#601)
96287a20a Add config option "summaryLength" (#600)
ced7f2085 Adjust Over showcase
e334a6354 Add new showcase: over
10435b502 Add warning about privacy options only work with internal templates (#525)
48c6b0e4d Minor grammatical fix
684670ebc Add quote
0e9fada52 Improvements to taxonomy template examples
e06c4bf73 Add syntax highlighting; consistent 4-space indentation
c1cb3f081 Remove dead links for custom permalinks
3e3aefd04 Fix 0a671bc3751479e74a0a9d2132736c61d239707c
d65888685 fix file name in 'Add Non-content Entries to a Menu' code toggle (#547)
1a0563857 Add Solus install guide (#590)
8a0d65b0d Update Windows Installation instructions (#564)
c4348636a Fix typo
0a671bc37 Add post to menu example
af14497c6 Add notes for `os.Stat` (Hugo 0.47) (#557)
e49f65bb3 Singular to plural
cb5608dbf Update introduction.md
30b060dff Add variable re-definition example (Hugo v0.48+)
21123967e Minor edits
fac3df043 Refresh the Go Templates introduction
4a9600e92 Updating URL to how-to-guide for hosting hugo site on firebase
bfaa7779c add missing word
c2cb5d09b Tweak 'name: weight' to 'name: date' in example (#582)
5ea938ad6 Remove some Scratch
2708dcd57 Release 0.48
e375d0f05 Merge branch 'temp48'
75e36c160 releaser: Prepare repository for 0.49-DEV
a6102f253 releaser: Add release notes to /docs for release of 0.48
41fc35db4 releaser: Bump versions for release of 0.48
64b9ecc74 Spell out the npm command for installing PostCSS
19e900a17 Improved Related Content doc
fe21600e7 Merge commit '844aef544c19e9d8f529b4f8144e089d0982bb34'
844aef544 Squashed 'themes/gohugoioTheme/' changes from 66249819..68ddff44
069828db8 Update git.md
d881d1433 Make default "related" behavior more explicit
60b9160eb Add docs for displaying 404 page on CloudFront
b72ebc760 Add .gitattributes to /resources
000cf85f4 Make the pros/cons styling consistent for summaries; use desc list
ebf1da97a Add note about outputStyle compressed
e3338ee91 Triple backquote syntax fix
361962a7c Add one more Blogger to Hugo tool for Windows (.NET Framework 4.5) (#540)
066606a21 Fix wrong link about Mmark Syntax Document
faee70757 Added exitwp-for-hugo
6b4108051 Add hugo-wrapper to starter-kits
4695dfba2 Added Utterances as Comments Alternatives.
c7ba9e3e1 Correct typo
beb850d9f Release 0.47.1
1cf417c8a Merge branch 'temp471'
0843bc46c releaser: Prepare repository for 0.48-DEV
8ff5c8b70 releaser: Add release notes to /docs for release of 0.47.1
e2353434d releaser: Bump versions for release of 0.47.1
ffb1300af Update development.md
c22234ea5 netlify: Minify output
5b9191c56 Release 0.47
bfd92cf52 releaser: Prepare repository for 0.48-DEV
ac7acf730 releaser: Add release notes to /docs for release of 0.47
b0096099d releaser: Bump versions for release of 0.47
86a7ae459 docs: Regenerate CLI docs
d2c8b72bc Merge commit 'a95896878f4b4a79448b39ce93a4e0d3258b4a43'
84de7ef59 Merge commit '3a44bf182fed5f34621f450114083a6dd7e88a07'

git-subtree-dir: docs
git-subtree-split: 6b00298bb26b700281df28817b6556e7480cdd1e

minifiers: Set minifier to KeepEndTags

See: https://github.com/tdewolff/minify/blob/948b6490cf3cacab5f4d7474104c3d21bf6eda46/README.md#L171

minifiers: Make JSON minification more generic

Add a regex matcher for json types. Specifically support LD+JSON which
allows for google seo minification out of the box. Expanded JS/JSON
minification testing.

Update Mage

tpl/data: Revise error handling in getJSON and getCSV

The most important part being: Log ERROR, but do not stop the build on remote errors.

Fixes #5076

tpl: Show error on union or intersect of uncomparable types

Fixes #3820

tpl/collections: Improve type handling in collections.Slice

Fixes #5188

tpl/collections: Allow pointer receiver in Group

See #4865

tpl/collections: Add group template func

This extends the page grouping in Hugo with a template function that allows for ad-hoc grouping.

A made-up example:

```
{{ $cool := where .Site.RegularPages "Params.cool" true | group "cool" }}
{{ $blue := where .Site.RegularPages "Params.blue" true | group "blue" }}
{{ $paginator := .Paginate (slice $cool $blue) }}
```

Closes #4865

hugolib: Allow creating page groups from any page collection

This also adjusts the pagination logic to allow for these new collections.

Note that we will follow up with a template function named `group` that will be the end user API. The `.Group` method on `Page` should be considered as internal.

Updates #4865

Update dependencies

tpl/strings: Add strings.FirstUpper

Fixes #5174

hugofs: Fix filepath issue in test

resource: Fix golint issues

Fix godoc comments and the following:

resource/image.go:33:2: a blank import should be only in a main or test package, or have a comment justifying it
resource/image.go:35:2: a blank import should be only in a main or test package, or have a comment justifying it
resource/image.go:41:2: a blank import should be only in a main or test package, or have a comment justifying it
resource/image.go:538:10: if block ends with a return statement, so drop this else and outdent its block
resource/resource.go:54:7: exported const DefaultResourceType should have comment or be unexported
resource/resource.go:233:1: receiver name r1 should be consistent with previous receiver name r for Resources
resource/resource.go:254:1: receiver name r1 should be consistent with previous receiver name r for Resources

Improve some godoc comments

tpl: Fix golint godoc issues

media: Fix golint issues

Fix godoc issues and the following:

media/mediaType.go:228:1: receiver name t should be consistent with previous receiver name m for Type

output: Fix golint godoc issues

publisher: Fix golint godoc issue

langs: Fix golint godoc issue

i18n: Fix golint issue

i18n/translationProvider.go:48:21: error strings should not be capitalized or end with punctuation or a newline

related: Fix golint issues

related/inverted_index.go:76:1: exported method Config.Add should have comment or be unexported
related/inverted_index.go:255:1: exported method IndexConfig.ToKeywords should have comment or be unexported

releaser: Fix golint issues

struct field HtmlURL should be HTMLURL

source: Fix golint godoc issues

hugofs: Fix golint issues

Fix godoc issues and the following:

hugofs/noop_fs.go:25:2: error var noOpErr should have name of the form errFoo

helpers: Fix golint issues

helpers/general.go:448:1: comment on exported function DiffStrings should be of the form "DiffStrings ..."
helpers/hugo.go:42:6: exported type HugoVersionString should have comment or be unexported
helpers/hugo.go:48:1: exported method HugoVersion.Version should have comment or be unexported
helpers/hugo.go:56:1: comment on exported method HugoVersionString.Compare should be of the form "Compare ..."
helpers/hugo.go:62:1: comment on exported method HugoVersionString.Eq should be of the form "Eq ..."
helpers/path.go:548:1: comment on exported function OpenFilesForWriting should be of the form "OpenFilesForWriting ..."
helpers/processing_stats.go:24:6: exported type ProcessingStats should have comment or be unexported
helpers/processing_stats.go:55:1: exported function NewProcessingStats should have comment or be unexported
helpers/processing_stats.go:59:1: exported method ProcessingStats.Incr should have comment or be unexported
helpers/processing_stats.go:63:1: exported method ProcessingStats.Add should have comment or be unexported
helpers/processing_stats.go:67:1: exported method ProcessingStats.Table should have comment or be unexported
helpers/processing_stats.go:83:1: exported function ProcessingStatsTable should have comment or be unexported

deps: Fix most golint issues

deps/deps.go:79:6: exported type Listeners should have comment or be unexported
deps/deps.go:86:1: exported method Listeners.Add should have comment or be unexported
deps/deps.go:92:1: exported method Listeners.Notify should have comment or be unexported

config: Fix golint issues

config/configProvider.go:54:9: if block ends with a return statement, so drop this else and outdent its block (move short variable declaration to its own line if necessary)
config/privacy/privacyConfig.go:99:1: exported function DecodeConfig should have comment or be unexported
config/services/servicesConfig.go:64:1: exported function DecodeConfig should have comment or be unexported

common: Fix golint errors

common/errors/errors.go:21:1: comment on exported var FeatureNotAvailableErr should be of the form "FeatureNotAvailableErr ..."
common/errors/errors.go:23:5: error var FeatureNotAvailableErr should have name of the form ErrFoo
common/maps/scratch.go:76:1: comment on exported method Scratch.Delete should be of the form "Delete ..."
common/maps/scratch.go:133:1: exported function NewScratch should have comment or be unexported
common/types/types.go:44:1: exported function NewKeyValuesStrings should have comment or be unexported

commands: Fix golint issues

commands/hugo.go:65:1: exported method Response.IsUserError should have comment or be unexported
commands/import_jekyll.go:100:21: error strings should not be capitalized or end with punctuation or a newline
commands/server.go:417:1: receiver name sc should be consistent with previous receiver name s for serverCmd

hugolib: Do not FirstUpper taxonomy titles

Doing so was probably a mistake. This may be a breaking change for some people,
but it's easy to restore the previous behaviour in the layouts.

Fixes #5172

Fix broken Travis config

See https://github.com/magefile/mage/issues/79

Update to latest Mage

And run the Appveyor tests without GOPATH.

Fixes https://github.com/magefile/mage/issues/79

resource: Fix broken build

resource: Remove some duplicate code

Update Dockerfile to Go 1.11

Fixes #5145

hugolib: Simplify some code

hugolib: Add missing error checks

hugolib: Remove extraneous createStaticFs call

This looks like a copy+paste error.  We have the same line a few lines
below this call and we actually handle the err value there.

hugolib: Fix godoc comment

hugolib: Fix typo in private func name

Fix error message for go vet

mage: Init packages once

`go list ./...` fails when run in parallel on Windows. This also applies to running `go test ./...` and `go list/...` so we serialize tests.

appveyor: Update script to Go 1.11

Fixes #5127

build: Remove the remains of Go Dep

Appveyor is now Go 1.11 ready, so we can go all "Go Modules".

Closes #5115

Update CONTRIBUTING.md

Update README.md

snapcraft: Update to work with Go Modules

releaser: Prepare repository for 0.49-DEV

[ci skip]

releaser: Add release notes to /docs for release of 0.48

[ci skip]

releaser: Bump versions for release of 0.48

[ci skip]

Release 0.48

releaser: Add release notes draft for 0.48

Rename to *-ready.md to continue. [ci skip]

release: Fix CircleCI script

hugolib: Only run variable variable overwrite test on Go 1.11

hugolib: Add a test for template variable overwrite

New in Go 1.11.

helpers: Fix permissions when creating new folders

This was mistakingly changed from 07777 (rwx, rw, r before umask) to 0755 in Hugo 0.37. This commit reverts to the old value.

Fixes #5128

Improve minifier MIME type resolution

This commit also removes the deprecated `Suffix` from MediaType. Now use `Suffixes` and put the MIME type suffix in the type, e.g. `application/svg+xml`.

Fixes #5093

circleci: Update to Go 1.11

See #5115

travis: Set GO111MODULE=on for mage install

See #5115

resource: Add instruction to install PostCSS when missing

Fixes #5111

Update snapcraft build config to Go 1.11

See #5115

Use Go 1.11 modules with Mage

See #5115

Add go.mod

See #5115

Update Travis to Go 1.11 and Go 1.10.4

See #5115

minfiers: Keep end tags

Fixes  #5112

snap: Skip installing postcss due to failure on build server

npm running on fails to fetch postcss-cli on build.snapcraft.io
due to network proxy issue.

See https://forum.snapcraft.io/t/build-fails-behind-proxy-on-build-snapcraft-io/6951/3

snap: Refactor, fix bin/node, and add bin/postcss

hugolib: Include language code in REF_NOT_FOUND errors

Fixes #5110

tpl/tplimpl: Make the autogenerated templates collapsed in PRs

 Fix handling of taxonomy terms containing slashes

Fixes #4090

Fix build on armv7

Closes #5101

releaser: Prepare repository for 0.48-DEV

[ci skip]

releaser: Add release notes to /docs for release of 0.47.1

[ci skip]

releaser: Bump versions for release of 0.47.1

[ci skip]

Release 0.47.1

releaser: Add release notes draft for 0.47.1

Rename to *-ready.md to continue. [ci skip]

tpl/tplimpl: Fix .Site.Params case regression

Fixes #5094

snap: Remove unused files from Git, Perl, etc.

Snap size reduced from 46MB to 26MB.

snap: Add nodejs to allow PostCSS to work

See https://discourse.gohugo.io/t/snap-pipeline-error-with-postcss-environment-issue/13583

minifiers: Do not strip IE conditional statements

Fixes #5089

releaser: Prepare repository for 0.48-DEV

[ci skip]

releaser: Add release notes to /docs for release of 0.47

[ci skip]

releaser: Bump versions for release of 0.47

[ci skip]

releaser: Work around a Goreleaser bug

Closes #4918

Release  0.47

releaser: Add release notes draft for 0.47

Rename to *-ready.md to continue. [ci skip]

docs: Regenerate CLI docs

Squashed 'docs/' changes from d88477eb3..9b494a58c

9b494a58c Add comma in example config
1c24f672d Update multilingual.md
8bf85bfe4 Cosmetic change to test GitInfo
3b53b54f9 Update installing.md
e3b8eb941 Get arolla-cocoon showcase ready for publishing
7b7931e59 Add  "Cocoon Arolla showcase"
c9cc7852c Add "scoop install hugo" for quick install on Windows
3037527fe Update Directory Structure following Hugo Pipes
dbecb967d Add `assetDir` key to config list
488d1d034 Remove alias.txt

git-subtree-dir: docs
git-subtree-split: 9b494a58cd96ec42a4fc63c389c01523d144e03f

Merge commit 'a95896878f4b4a79448b39ce93a4e0d3258b4a43'

tpl/tplimpl: Fix compiling Amber templates that import other templates

Without this patch, amber would try to load templates from the OS filesystem
instead of the layouts virtual filesystem.

hugolib: Adjust tests for shortcode p-issue

See #1642

hugolib: Fix shortcode output wrapped in p

Fixes #1642

Add configFile(s) back to the watch list after REMOVE event

Fixes #4701

commands: Gracefully handle typos in server config when running the server

Fixes #5081

hugolib: Fix image cache-clearing for sub-languages

Fixes #5084

hugolib: Force render of any changed page, even in Fast Render Mode

Fixes #5083