Add description in index page

[mmesiti]

Description should be adjusted - I have not put much thought into what to write there, I wanted just to explore how this is technically possible. For consistency, one could use the most appropriate of the already existing blobs of text.

Example: https://mmesiti.github.io/2026-03-17-workshop/

[samumantha]

Since it will likely stay a short text, could we add it more directly, without separate html?

It's already quite a bunch of files to check and not always clear where content is actually located.

---

We could have it in shape/tone of a subtitle ?

"- Useful tools and techniques for researchers who code"?

Or something like that?

[samumantha]

Since it will likely stay a short text, could we add it more directly, without separate html?

It's already quite a bunch of files to check and not always clear where content is actually located.

---

We could have it in shape/tone of a subtitle ?

"- Useful tools and techniques for researchers who code"?

Or something like that?

[mmesiti]

Since it will likely stay a short text, could we add it more directly, without separate html?

It's already quite a bunch of files to check and not always clear where content is actually located.

I don't know why the decision was made to have so many files. In index.html for example there are a number of included files which are actually included only in index.html, so one could potentially just splice them where they are included. But if this was done in this way, perhaps there is a reason (separation of concerns?)

We could have it in shape/tone of a subtitle ?

"- Useful tools and techniques for researchers who code"?

Or something like that?

For sure!

[samumantha]

Yea, there is likely a reason for that. Let's leave as separate files.

[samumantha]

Any preference about the text?
You mentioned description should be adjusted in issue text, does that mean you did not like the one you had?

[samumantha]

Could you add a screenshot on how your solution looks rendered, please?
Something is off with my setup :/

[mmesiti]

Could you add a screenshot on how your solution looks rendered, please? Something is off with my setup :/

Example: https://mmesiti.github.io/2026-03-17-workshop/

[mmesiti]

Any preference about the text? You mentioned description should be adjusted in issue text, does that mean you did not like the one you had?

I did not put much thought into it, that's all, as I do not feel I should take decisions on what is written so close to the title of a CodeRefinery workshop, since I'm just kind of a CodeRefinery hitchhiker/freeloader :-).

[mmesiti]

Yea, there is likely a reason for that. Let's leave as separate files.

Useless digression

From the log of the index.html file on the template repo, I can see that it was mostly @bast adding more include directives in the template, to keep the templates/ directory more modular, and that resonates very well with me as a programmer.
But if I were a layman person that just wants to change something in the workshop page (or just someone who is not familiar with the templates and and is doing this through the github web interface and CTRL+F is their only option) then every additional level of indirection would make things more complicated for me (until I learn how these templates work).

It's yet another instance of the flat vs nested, modular vs monolithic approach.