Merge commit '9b0050e9aabe4be65c78ccf292a348f309d50ccd' as 'docs'

```
git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash
```

Closes #11925

docs/content/en/methods/resource/Permalink.md

@@ -0,0 +1,25 @@
+---
+title: Permalink
+description:  Publishes the given resource and returns its permalink.
+categories: []
+keywords: []
+action:
+  related:
+    - methods/resource/RelPermalink
+    - methods/resource/Publish
+    - methods/resource/Key
+  returnType: string
+  signatures: [RESOURCE.Permalink]
+---
+
+The `Permalink` method on a `Resource` object writes the resource to the publish directory, typically `public`, and returns its [permalink].
+
+[permalink]: /getting-started/glossary/#permalink
+
+```go-html-template
+{{ with resources.Get "images/a.jpg" }}
+  {{ .Permalink }} → https://example.org/images/a.jpg
+{{ end }}
+```
+
+{{% include "methods/resource/_common/global-page-remote-resources.md" %}}