Document author (getzola#2347)

* Add author to documentation for config.toml

* Add explanation of how author is used for feeds

docs/content/documentation/getting-started/configuration.md

@@ -82,6 +82,9 @@ feed_filename = "atom.xml"
 # files are always copied, regardless of this setting.
 hard_link_static = false
 
+# The default author for pages
+author = 
+
 # The taxonomies to be rendered for the site and their configuration of the default languages
 # Example:
 #     taxonomies = [

docs/content/documentation/templates/feeds/index.md

@@ -23,6 +23,20 @@ check the documentation for the specifications for Atom 1.0 and RSS 2.0 in
 
 **Only pages with a date will be available.**
 
+The author in the feed is set as
+- The first author in `authors` set in the 
+  [front matter](@/documentation/content/page.md#front-matter)
+- If that is not present it falls back to the `author` in the 
+  [Configuration](@/documentation/getting-started/configuration.md)
+- If that is also not preset it is set to `Unknown`.
+
+Note that `atom.xml` and `rss.xml` require different formats for specifying the
+author. According to [RFC 4287][atom_rfc] `atom.xml` requires the author's
+name, for example `"John Doe"`. While according to the 
+[RSS 2.0 Specification][rss_spec] the email address is required, and the name
+optionally included, for example `"[email protected]"` or 
+`"[email protected] (Lawyer Boyer)"`.
+
 The feed template gets five variables:
 
 - `config`: the site config
@@ -69,3 +83,6 @@ In order to enable the tag feeds as well, you can overload the `block rss` using
 {% endblock rss %}
 ```
 Each tag page will refer to it's dedicated feed.
+
+[atom_rfc]: https://www.rfc-editor.org/rfc/rfc4287
+[rss_spec]: https://www.rssboard.org/rss-specification#ltauthorgtSubelementOfLtitemgt