I was not able to find a precise GitHub issue on the topic, please direct me to one if it exists, otherwise, I’ll create one.
On a taxonomy page (sports/), the .Kind value outputs taxonomyTerm
On a taxonomy term page (sports/football/), the .Kind value outputs “taxonomy”
Also, to set an output format to a taxonomy term page, you have to set it to taxonomy:
taxonomy = ["json"]
While trying to set an output format to a taxonomy page doing the opposite does not work:
taxonomyTerm = ["json"]
The problem has been referenced several times in the discourse or GitHub and while I understand fixing it would potentially break codes, I think we need to have an GitHub issue about it for reference and specing.
I still have to understand the concept of Value from the movie exemple. But the terminology to define “taxonomy” vs “taxonomy term” is at odds with most other CMS… wordpress, drupal
I am not saying there is a right and wrong here, just that maybe this distinction with other frameworks where “sport” would be the taxonomy and “football” would be a term will lead to confusion (it already does) for many dev and possibly editors.
Thanks for your answer. Will get back here if I think about a way to counter this confusion
So I understand that the sport page and the football page have two different purposes. The former lists all sports terms, while the latter lists all entries with the sport term “football” assigned to it.
But it still does not compute in my head why the sports page is of .Kind “taxonomyTerm” and the “football” page is of .Kind “taxonomy”
If anyone can help me understand so I can later explain it to whomever is concerned, I’ll gladly appreciate it.
I assume I chose those terms based on terms used in the code itself. It is easy to pick on decisions in hindsight – some may make more sense than others. This is is one of those not worth even considering trying to change.
Just imagine the havoc if I decided to just switch those around.
Not in a million years would I dare criticize decisions and work of others. My only pestering for finding a sense in this terminology was that, more often than not, I don’t instantly comprehend the sense of some stuff and need more help than others. So that might also have been the case.
Also, of course I don’t think it can be changed now, I was merely opening a channel for discussing how we can counter the confusion often triggered by this terminology (by looking for a sense).
I will think of a place in the doc where page “Kinds” can be listed and explained. This way people won’t be confused anymore by taxonomy/taxonomyTerm and when they are, we’ll redirect them to this doc page/chapter.