Gitorials

Learning and science

interactive tutorials

SHOW HN2017

147points
25comments
#259of 2,242 in 2017
Top 12%of 2017 by points

How HN took it

MixedNo clear lean

5 positive, 3 neutral or asking, 1 mixed, 2 critical, out of 11 comments about the project. Thread score +0.19.

Idea: 5 for, 0 againstExecution: 0 for, 1 againstDocs: 0 for, 1 against

The thread, comment by comment

Each row is a top-level comment and its replies, in HN's order. Select a cell to open that comment on HN.

positive neutral or mixed critical about another commenter or something else the maker

What HN said

What people liked

  • Stepping through commits and diffs makes tutorials easier to follow

    From 2 comments
    • I've tried this idea out before (on three occasions, with different approaches, but the same name :P). I think this approach has a lot of promise. Compared to normal blog posts,…
      z1mm32m4n on HN
    • I think that this is a great idea!! Following the commit tree allows you to easily modify the code without breaking it, and then quickly test out the results by running it while…
      kovek on HN
  • Concept holds promise for interactive learning

    From 2 comments
    • I've tried this idea out before (on three occasions, with different approaches, but the same name :P). I think this approach has a lot of promise. Compared to normal blog posts,…
      z1mm32m4n on HN
    • With a business like this it's more important to make it easy on the content providers than optimizing the user experience for consumers. At some mass the algebra changes and…
      addcn on HN

Objections

  • Brittle when steps are edited; rebasing changes commit hashes

    From 1 comment
    • I've tried this idea out before (on three occasions, with different approaches, but the same name :P). I think this approach has a lot of promise. Compared to normal blog posts,…
      z1mm32m4n on HN
  • CLI-only workflow is a barrier, especially on mobile

    From 2 comments
    • I've tried this idea out before (on three occasions, with different approaches, but the same name :P). I think this approach has a lot of promise. Compared to normal blog posts,…
      z1mm32m4n on HN
    • So instead of running the code for your interactive tutorial in my very handy cross-platform graphical javascript sandbox I should clone a git repo and run a shell script that…
      colemannugent on HN

Requests

  • Run tutorials in the browser without a local CLI

    From 2 comments
    • I've tried this idea out before (on three occasions, with different approaches, but the same name :P). I think this approach has a lot of promise. Compared to normal blog posts,…
      z1mm32m4n on HN
    • That is a valid point -- I had to get quite used to git rebase while making the initial gitorials =) If all you need to modify is the commit messages, this tool apparently is a…
      gw on HN
  • Playback tool with annotations for stepping through commits

    From 1 comment
    • It would be cool to make a tool for 'playing back' git repos like this. I could see it having media player style controls so you can jump anywhere in progress, step to the next…
      westoncb on HN

Questions

  • How to make corrections or add content as a contributor

    From 1 comment
    • It would be cool to have a Gitorial about using Gitorials.com. I get the idea of this project but don't really know where to start and how to do it (like make corrections, add…
      superasn on HN

Alternatives named

  • Blog posts with linked commits (Practical Redux series)

    From 1 comment
    • I've been trying to something sort of along this line with my "Practical Redux" tutorial series ( http://blog.isquaredsoftware.com/series/practical-redux ), as well as other…
      acemarke on HN
  • HelloGit tutorial repo

    From 1 comment
    • I had the same idea a couple of years ago, but never created a business or a website for it. Here's the one tutorial I created this way (NodeJS + Express):…
      jtwaleson on HN
  • Kondiment HTML tutorial generator

    From 1 comment
    • I made a similar tool if you want to output a nicely formatted HTML tutorial: http://github.com/alexspeller/kondiment
      spellboots on HN

Category, keywords, summaries and labels on this page were made by AI (Thread Reader v2) and not checked by hand. Each point links to the comments it came from.

Add a badge to your READMEShown on HackerShow
[![Shown on HackerShow](https://hackershow.org/badge.svg)](https://hackershow.org/show/14330635)