Open hdodov opened 4 years ago
https://getkirby.com/docs/guide/tour#a-peak-under-the-hood-kirby-s-folder-structure
But yes, this list doesn't contain the subfolders. And the assets folder was left out on purpose and is only mentioned underneath.
@texnixe well, I guess you could rewrite the intro of that article to include all folders. I think that the assets
folder shouldn't be left out as long as Kirby has some special relationship with it. The assets
root exists, therefore the assets
folder has a special meaning.
In my opinion, that article could be renamed to something like "Exploring the Roots" where you could use unordered lists to describe what's the purpose of each root. It even semantically makes sense - starting at the roots means really starting at the beginning.
I've used Kirby for about 3 years and I've only now realized that there are roles
and collections
roots. I think that each root here should be in the Guide, even with just a tiny one-liner description of what it does or how it can help you.
Perhaps the Starterkit should also have all roots, each with a small README inside that explains what they do. If you want something without all that noise, you've still got the Plainkit.
A confusion in the forum about the
asset()
helper lead me to question what is the purpose of theassets
folder. As I wrote in the forum post, I think it'd be great if we had an intro page in the guide that described what each folder in a Kirby project is used for. Something like:Basically, you can see a brief overview of how a Kirby project works and use the links to the folders to jump into what you're interested, if you need more details. To me, it would glue the various documentation guides quite nicely and serve as a nice starting point for newcomers.