website icon indicating copy to clipboard operation
website copied to clipboard

2 FAQ folders in repo?

Open opusforlife2 opened this issue 1 year ago • 2 comments

@Poolitzer There seem to be two different folders containing FAQ answers or tutorials. What's up with this? can we unify them somehow?

opusforlife2 avatar Jul 17 '24 22:07 opusforlife2

Do you mean _tutorials and _faq or FAQ and _faq

Poolitzer avatar Jul 18 '24 07:07 Poolitzer

The latter. But the FAQ folder also contains a tutorials folder.

opusforlife2 avatar Jul 18 '24 10:07 opusforlife2

The FAQ folder is for the categories/the index page, the _faq is for the actual entry for each category.

Poolitzer avatar Oct 28 '24 11:10 Poolitzer

the directories starting with an underscore are internal dirs that are not served in production. They usually contain some kind of data or shared files like include and layouts (jekyll docs). This is done to separate the data and the way it is displayed (separation of concerns). This is also the case with the FAQ entries. The files taking care of the layout are stored in FAQ, the actual content is stored in _faq. We have the same concept for the blog posts, the post content is stored in _posts, the corresponding display logic and layout is store in blog. That distinction is useful and one of the core concepts of how Jekyll is structured.

TobiGr avatar Oct 29 '24 13:10 TobiGr