Using GitBook instead of the software-carpentery clone? about first-analysis-steps HOT 8 OPEN

I'm trialling GitBook (and the possibility of merging first and second-analysis-steps) in lhcb/starterkit-lessons.

from first-analysis-steps.

@RaoOfPhysics True, but I more meant about having a very long list of lessons to scroll through. @chrisburr has a nice solution in lhcb/starterkit-lessons#1.

from first-analysis-steps.

Hi, thanks for the pointer. Could you elaborate (or even better build a prototype) on what the advantages would be? The template works very well for us so far and all the SWC lessons it seems.

Right now we are busy preparing the actual material with a workshop coming up. Maybe in the future we can consider switching.

from first-analysis-steps.

Gitbook looks like a very nice choice. I can test it after the workshop next week.

from first-analysis-steps.

@betatim: I guess it's just more user-friendly, because one can change the colours and fonts, as I mentioned. Check out the built-in glossary on the CERN instances of GitBook: saves some trouble when you need to refer to a specific term repeatedly.

I can try porting your work to GitBook as an example, but I'm not an LHCb person and don't have the free time to do this just yet. :)

from first-analysis-steps.

It looks pretty good. I could help merge DevelopKit in too if this works out.

from first-analysis-steps.

Maybe the discussion is better had on that repo, but generally I think it's OK. I'm not sure about having all the lessons visible in the sidebar, I'm not sure if things start to look too cluttered. But it's better for visibility than having the lessons on separate websites, I suppose.

from first-analysis-steps.

@alexpearce:

I'm not sure about having all the lessons visible in the sidebar, I'm not sure if things start to look too cluttered.

A reader can collapse them so they're out of the way, using the "hamburger menu".

from first-analysis-steps.