So far we've gotten 112 comments from 30ish beta testers who have tried to
learn Git for the first using this tutorial. Most of them were able to
finish it successfully. By far the most common piece of feedback was that
people want to learn more about collaboration and branching. I've written a
draft of a tutorial on branching, but this is already quite a lot of words
so definitely we can't cover it in this series.

I don't know if it's possible to get this merged quickly, but if it were I
think it would be amazing since people are so eager for a tutorial on
branching. If we spend a huge amount of time revising this I think there's a
real risk I'll run out of funding before we have time to write about
branching. Ideally I think it would be great if we could merge a "good
enough" version and then have a way on the website for users to give
feedback on it, so that we can later incorporate that feedback and
iteratively make it better over time.

Here's all the "any other feedback?" comments that people left on the
tutorial (positive and negative), just to give a feeling for the overall
sentiment. I thought it was surprising but great that several people
described the tutorial as short or quick, because there are 14 steps and the
document is a bit long. this was feedback that people left as we were making
revisions, so some of it was on previous versions of the tutorial.

"I really enjoyed the tutorial. It didn't use too many words, when not
necessary and was precise, which I find appealing. The short explanations
were insightful and just the amount of information I was looking for (e.g.
that -m stands for message). I was looking for an easy tutorial that would
stretch just a little into collaboration, which I did not find here. Since I
already started learning git now, I will try to get there myself. So maybe
that's all I needed? I'll see. What this tutorial did to is take fear. At
least for me. I did get the hang of these commands in a short time, so I
want to keep going."

I have failed to learn to use git on a couple of previous occasions. This
was a really good way of stripping it down to the essentials. I think now
that my problem is that I speak English. This document is mostly written in
English, successfully enough that "make a commit" was the only part where
screeched to a halt. At the command line, "commit" was a verb again, so I
could proceed without confusion.

Thank you for your work.

Thank you for the tutorial

At first I was not sure I liked the long scrolling page. I'm still not sure
I like it. I thought the content was good for someone new to git. We never
did anything with the python file, so I found it odd we made it? (note from
julia: removed the python file in response to this)

This was a great tutorial and very easy to follow. Thank you!

A few explanations about why you do things would go a long way to make this
more useful

Sorry about the confusion, I jump around a lot so things admittedly get
jumbled..."

"aaaaa sorry i misremembered the ssh trouble I was having, my problem was
that the command in the tutorial didn't work for me so I just used the
regular url and entered my password... then looked up somewhere else how to
generate the ssh key later.

not at this time!! thank you for the tutorial :)

I think the tutorial is great ! It was very clear and the step by step is
well done

i will keep practicing using git and maybe some more good reasons will
appear in why should do revision control in this way. it has got me to make
more test cases.

Solid tutorial. Some topics took me 2 reads to get a grasp of but that may
be due to English not being my native language

I learned something new with "git -am" - all in all this was concise and
easy to follow. Thank you for your work!

It is short and felt quick. That my be good. But I would have liked to
continue for a bit more before I start using it more and collect practical
experience.

I would add that I was taking notes in a notebook while doing the tutorial
(I would also do it in a final tutorial), so maybe it took me more time. I
also wanted to thank you, I feel I got a structured knowledge.

What I was hoping to find is how to work with git in a team. When should I
merge, when should I branch, basically; how am I a good git-citizen

Thank you so much for the opportunity to participate! I learned a lot,
especially from the top offline section.

that was very useful. "git diff" or any "diff" i still find hard on the
eyes, but I noticed in my terminal it was different colors which helped me
work out the info that was being presented. I think in the past it was all
one color which made it harder to absorb. But so far so good. Thank you. I
learnt new stuff today.

Overall, I liked this tutorial a lot. I've done a bit with Git before and
never felt comfortable. Now I feel a bit more confident. I'm also open to
testing more and answering questions anytime you need. And "Thanks". Every
little bit I learn helps.

Overall though I really like the tutorial, it's easy to follow and I learned
a lot!

Julia Evans (2):
  doc: remove gittutorial
  doc: add new Git tutorial for beginners

 Documentation/gittutorial.adoc | 944 ++++++++++++++++++---------------
 1 file changed, 506 insertions(+), 438 deletions(-)

base-commit: c51408889c3b372814bc20b9431c3b74d0d268eb

Submitted-As: https://lore.kernel.org/git/pull.2248.v2.git.1792421748.gitgitgadget@gmail.com
In-Reply-To: https://lore.kernel.org/git/pull.2248.git.1791315422.gitgitgadget@gmail.com