search

root-project / web

root.cern
28 stars 51 forks source link

Modifying the outreach section of the website #1005

Closed martamaja10 closed 1 week ago

martamaja10 commented 1 month ago

Our outreach/learning section of the website is a bit outdated and not well organised. The idea is to, first of all, update the links to the most recent student-course and remove link duplications so if we are to share a link to a person who's only starting with ROOT we have it all nicely described and organised (and up to date).

Questions to be addressed later (maybe here or with separate PRs):

dpiparo commented 1 month ago

Good proposal. Preliminary comment: could you submit the pr from a branch of root-project/web so that the preview of the changes is available? Once this is there, I think we can converge quickly on the approval.

Then, more in details about your very relevant bullet points:

Do we leave the section as "Get Started" or do we rename it to, for example "Learn" (get started could be confusing as we also have a section "Install")

My personal opinion is that "Learn" would be clearer.

We keep adding links to the same things in many places (I started by deleting it from the Manual section), I think we should clean the ROOT Reference Documentation: https://root.cern/doc/master/index.html entry page?

My personal opinion is that all duplications should be eliminated.

It would be a great time to also sort out our Tutorials and make sure what we have is really relevant and not outdated

I believe you are right. Periodically this work is more than welcome: this is relative to the main root repository though, and I would move the discussion there if you agree. We have a legacy category there to collect old tutorials. New tutorials could be written if any important feature is not properly illustrated. Moreover, legacy usage of classes/C++ could be corrected, for example using modern (yet simple) C++. It's not a lot of work, but with a great impact: tutorials are our code examples, from which people can start copying or being inspired.

Shall we add a "Teachers' corner" somewhere where we point external instructors to the newest and best material they should teach as well? And our recommendation what they should teach about?

My personal opinion is that kind of information would be very welcome. The name should come out by consensus of the team, but I think a name like "For teachers" could be clearer.

dpiparo commented 1 month ago

Hi marta. Can you submit this very PR but after pushing your branch to this repo and not your fork? This would allow the CI to build a test version of the site we can vision What do you think?