Adding Wikipedia-style "[citation needed]" when explanations are missing

[josebolos]

Meta-issue about the Playbook itself, to discuss.

I think that it's fair to say that we want the stuff contained in the Frontend Playbook to be as objective as reasonably possible, and the guidelines contained based on researched facts rather than on personal preference. The Playbook has grown a lot over the years, people have come and go, and as a result it's possible that the reasoning for certain practices may have been lost.

I propose that we find a way to mark statements that may need backing up, so that people reading the Playbook know that something is incomplete. They may even consider contributing to fill in the gap!

A way to do this could be using a mechanism similar to Wikipedia's [citation needed], so for example, on the following example taken from https://github.com/springernature/frontend-playbook/blob/main/performance/browser-caching.md#css-js-and-images

Frameworks like Shunter use the filename version style which is preferred.

There's no reasoning why the filename version style is preferred, so we could include a "[citation needed]" or "[reason missing]" or "[y tho]" link to a new page explaining that something is missing, and person wanting to contribute to the Playbook may decide to help improve the text:

Frameworks like Shunter use the filename version style which is preferred.^{[y tho?]}

Thoughts?