Deprecate page.Author and page.Authors

These are not documented, and they don't belong on Page. We should consider having author a first class citizen of Hugo, but as it is not it's better modelled as a taxonomy.
gohugoio · Apr 23, 2022 · 097fd58 · 097fd58
1 parent 41cc4e4
commit 097fd58
Show file tree

Hide file tree

Showing 2 changed files with 5 additions and 0 deletions.
diff --git a/hugolib/page__meta.go b/hugolib/page__meta.go
@@ -131,6 +131,7 @@ func (p *pageMeta) Aliases() []string {
 }
 
 func (p *pageMeta) Author() page.Author {
+	helpers.Deprecated(".Author", "Use taxonomies.", false)
 	authors := p.Authors()
 
 	for _, author := range authors {
@@ -140,6 +141,7 @@ func (p *pageMeta) Author() page.Author {
 }
 
 func (p *pageMeta) Authors() page.AuthorList {
+	helpers.Deprecated(".Authors", "Use taxonomies.", false)
 	authorKeys, ok := p.params["authors"]
 	if !ok {
 		return page.AuthorList{}

diff --git a/resources/page/page.go b/resources/page/page.go
@@ -52,7 +52,9 @@ type AlternativeOutputFormatsProvider interface {
 
 // AuthorProvider provides author information.
 type AuthorProvider interface {
+	// Deprecated.
 	Author() Author
+	// Deprecated.
 	Authors() AuthorList
 }
 
@@ -118,6 +120,7 @@ type InSectionPositioner interface {
 
 // InternalDependencies is considered an internal interface.
 type InternalDependencies interface {
+	// GetRelatedDocsHandler is for internal use only.
 	GetRelatedDocsHandler() *RelatedDocsHandler
 }