Adding git graphs to the materials?

[davidwilby]

Feel free to disagree! (also could move this to GH discussions if we think it would be beneficial)

I think that a couple of additional visuals would help me personally when delivering this training to illustrate some of the concepts around commits and branches.

In the advanced collaboration section, I wonder if we could do with a diagram that shows branching a bit more visually.

The current diagram we have here:

does a good job illustrating the flow IMO, but doesn't visually show the branching concept.

We could add something like the following to show branching a bit more clearly.

gitGraph
    commit
    commit
    commit
    commit
    commit
    branch feature
    checkout feature
    commit
    commit
    checkout main

Loading

(aside: check out this sweet mermaid gitgraph feature)

Which could then be extended to show the pull request and merge steps, e.g.

gitGraph
    commit
    commit
    commit
    commit
    commit
    branch feature
    checkout feature
    commit
    commit
    checkout main
    merge feature

Loading

I'd be interested to know others' thoughts on this.

[EdwinB12]

Having just done the course as a participator, I came to post this exact issue. I think the above gitgraphs (very nice!) are a welcome addition to explain the power of branching.

[ns-rse]

Further using git-sim might be useful to help visualise some aspects.

Most recent run of the course people were asking a lot of questions about the difference between forking and cloning. The slides do already cover this I think but animations are pretty!

[ns-rse]

This can be done by leveraging mermaid.live which once you've constructed your graph provides a link to embed it in Markdown under the Action button on the bottom left, it provides...

[![](https://mermaid.ink/img/pako:eNqlVl1v2jAU_SuWJcQLQ4kTKMkb68fWqV23frxMvJjkBqwmNnKcjhbx33eTkAloUgglD9jxOdfHvuc6XtFAhUB92umshBTGJ6uumUMCXZ90pzyFbo90Z8J803wx7-ajWhlu4FwliTA3fAoxvjU6g_VEkuqH7XWnU76oyP-Hg4JKROiTCb3hqSERcJNpmNB6zIvVt_vW1uhUcxnMNyMkEktI33Mn9HEu0gqLrUjpEkuMIjmzLuKtSFMhZ-THw91PRMdQ8vbgO_LGYUiSbdomfN_ahN0mziF4Vplp0p6AnsFpMoop7bq5Ei5kPeeq3Hi7Cs52trkOyo6AvhvdzhdrylfJPZAz1i5nrGXO2OGcsRNyVq9aacDYXM6O0Pu0CLHoyDkPQb5xEquZOgC9vxxf3F6esow2uoo9a2m6ahFf8XSJhWws-yc8jsgjpKaUAS88zrhROj2WIHERATTjUbzT6FPnUz516qJeiWXuj1QlYOZ5S0iCZy2JsryyiJL7zN0CFMsmamOWncYst9dywD7tVsk-WmWOTnkCZKHVNIak4pxemp_TVJictdjk9y5rWSL3EPEArU6-j8e_r5sib6EejkP9uv5ApdtYC-6nasGt37li9Y0u0HgtUBFukXwlEv5WV4S0MQvuh47cTf2-qH0DVr6zN844CszqwAckbvnzeIVFqloa6kbhoZjkJ_vmVExAGlRCexQ1IC_EK-Aq505ocf2b0JwWcv2cT7RGXFZ8Vy5DgV6ifn7j61GeGfXwKoOqX2IuBJ9pnlQvF1z-UQq7EY_Tsk_9FV1S_4s7svre4Awfy3OHbDQa9Ogr9YdWf2ixgWfZtufhn7fu0bciBH6gmWs5o4HtDJyh552t_wG-Kjr8?type=png)](https://mermaid.live/edit#pako:eNqlVl1v2jAU_SuWJcQLQ4kTKMkb68fWqV23frxMvJjkBqwmNnKcjhbx33eTkAloUgglD9jxOdfHvuc6XtFAhUB92umshBTGJ6uumUMCXZ90pzyFbo90Z8J803wx7-ajWhlu4FwliTA3fAoxvjU6g_VEkuqH7XWnU76oyP-Hg4JKROiTCb3hqSERcJNpmNB6zIvVt_vW1uhUcxnMNyMkEktI33Mn9HEu0gqLrUjpEkuMIjmzLuKtSFMhZ-THw91PRMdQ8vbgO_LGYUiSbdomfN_ahN0mziF4Vplp0p6AnsFpMoop7bq5Ei5kPeeq3Hi7Cs52trkOyo6AvhvdzhdrylfJPZAz1i5nrGXO2OGcsRNyVq9aacDYXM6O0Pu0CLHoyDkPQb5xEquZOgC9vxxf3F6esow2uoo9a2m6ahFf8XSJhWws-yc8jsgjpKaUAS88zrhROj2WIHERATTjUbzT6FPnUz516qJeiWXuj1QlYOZ5S0iCZy2JsryyiJL7zN0CFMsmamOWncYst9dywD7tVsk-WmWOTnkCZKHVNIak4pxemp_TVJictdjk9y5rWSL3EPEArU6-j8e_r5sib6EejkP9uv5ApdtYC-6nasGt37li9Y0u0HgtUBFukXwlEv5WV4S0MQvuh47cTf2-qH0DVr6zN844CszqwAckbvnzeIVFqloa6kbhoZjkJ_vmVExAGlRCexQ1IC_EK-Aq505ocf2b0JwWcv2cT7RGXFZ8Vy5DgV6ifn7j61GeGfXwKoOqX2IuBJ9pnlQvF1z-UQq7EY_Tsk_9FV1S_4s7svre4Awfy3OHbDQa9Ogr9YdWf2ixgWfZtufhn7fu0bciBH6gmWs5o4HtDJyh552t_wG-Kjr8)

Which renders as...