2 FAQ folders in repo?

Question

2 FAQ folders in repo?

Closed this issue 2 months ago · 4 comments

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

Answer 1 · 2024-07-18T07:30:12.000Z

Do you mean _tutorials and _faq or FAQ and _faq

Answer 2 · 2024-07-18T10:00:29.000Z

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

Answer 3 · 2024-10-28T11:34:37.000Z

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

Answer 4 · 2024-10-29T13:36:08.000Z

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.