git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: What's cooking in git.git (topics)

From
Johan Herland <johan@herland.net>
Date
Nov 29, 2007, 08:24 UTC
Message-ID
<200711290924.12508.johan@herland.net>
In-Reply-To
<7vlk8hzx0g.fsf@gitster.siamese.dyndns.org>
On Thursday 29 November 2007, Junio C Hamano wrote:
Show 29 quoted lines
> Nicolas Pitre <nico@cam.org> writes:
> > ...  In all the tutorials for $job I've done so 
> > far, I simply never talk about pull nor clone, but rather about init, 
> > "git remote", fetch and merge, with explicit and meaningful branch 
> > names.  I think that basic commands, even if there is a bit more of 
> > them, make Git easier to learn and understand than talking about those 
> > magic meta commands hiding the truth away.
> 
> That's actually a quite interesting approach for teaching.
> 
> The original "tutorial" (now core-tutorial) was similar in spirit; it
> built the user experience by starting at sequence of low level commands,
> and then finally said "since this is so often used combination, there is
> a short-hand for it that does all".  I think the approach would work
> quite well for people who want to use the tool with deep understanding.
> 
> However, I am not so sure about people who just want canned set of
> instructions and follow them blindly to get their work done.  And I do
> not think the latter classes of users are necessarily wrong.
> 
> Such a canned set of instructions would (if the project that supplies
> the cheat-sheet encourages merges instead of rebases) talk about "clone
> then commit then push then pull and repeat", without mentioning what
> pull does is fetch+merge nor what fetch means and what merge means, and
> that would let people get started without deeper understanding.
> 
> But the lack of deeper understanding would hurt them in the longer run
> (e.g. "my push was rejected with something called non-fast-forward ---
> what does that mean and what would I do now?").  

What about ending the cheat-sheet with a big fat link to a FAQ? The FAQ answers common questions like the above (resulting from the cheat-sheet glossing over the details) with links to appropriate sections in the more thorough introduction (core-tutorial), explaining what's _really_ going on.

Just a thought.
Have fun! :)
...Johan
-- 
Johan Herland, <johan@herland.net>
www.herland.net
Previous: Junio C HamanoNext: Nicolas Pitre
Message 19 of 22 in “Re: What's cooking in git.git (topics)”
  1. しらいしななこNov 27, 2007
  2. Johannes SchindelinNov 27, 2007
  3. Andreas EricssonNov 27, 2007
  4. Johannes SchindelinNov 27, 2007
  5. Andreas EricssonNov 27, 2007
  6. Nicolas PitreNov 27, 2007
  7. J. Bruce FieldsNov 27, 2007
  8. Nicolas PitreNov 27, 2007
  9. J. Bruce FieldsNov 27, 2007
  10. Nicolas PitreNov 27, 2007
  11. J. Bruce FieldsNov 27, 2007
  12. Johannes SchindelinNov 27, 2007
  13. J. Bruce FieldsNov 27, 2007
  14. Andreas EricssonNov 28, 2007
  15. Nicolas PitreNov 27, 2007
  16. Junio C HamanoNov 29, 2007
  17. J. Bruce FieldsNov 29, 2007
  18. Junio C HamanoNov 29, 2007
  19. Johan HerlandNov 29, 2007
  20. Nicolas PitreNov 29, 2007
  21. Junio C HamanoNov 27, 2007
  22. Johannes SchindelinNov 27, 2007

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.