I guess the viewpoint and perspective from the more experienced users may be different. The veterans may start to take some knowledge for granted, as a given knowledge that they may thing people would already know.
For example, the underlying concept of git commit is something that I now take for granted. But it's something that I have to really visit and talk about when I'm teaching a friend to use git. Perhaps we need contributions from people who have only just learned how to properly use git, rather than only having veterans write the guide up. People who still have the learning experience fresh in their minds. And perhaps we also need contributions from people who routinely teach their friends about git. On Thu, May 9, 2013 at 12:54 AM, Chad <innocentkil...@gmail.com> wrote: > Well, that was the point of [[Git/Getting started]] because the Workflow > document sucks. > > -Chad > > On Wed, May 8, 2013 at 12:41 PM, Petr Bena <benap...@gmail.com> wrote: > > I was using these tutorials in past, and they were pretty complicated > > for me to understand git. I don't say it should be considered some > > "official" documentation, rather something what desperate people could > > use. > > > > Git/Workflow and such are written by people who already understand git > > - they don't see what seems complicated to newbies or what is really > > hard and makes git evil to new users. I think some far, far simpler > > guide like "git for dummies" or whatever similar, could be useful for > > many new contributors who have no idea about git. > > > > On Wed, May 8, 2013 at 6:37 PM, Chad <innocentkil...@gmail.com> wrote: > >> On Wed, May 8, 2013 at 12:34 PM, Petr Bena <benap...@gmail.com> wrote: > >>> Hi, > >>> > >>> Long time ago when I started learning with git I decided to create a > >>> simple guide (basically I was just taking some notes of what is > >>> needed). I never thought that it could be useful to anyone so I never > >>> announced it anywhere. However I got some feedback to it, so I decided > >>> to inform you too. > >>> > >>> The basic idea is to create a TOTALLY SIMPLE guide that git > >>> illiterates like me can understand and thanks to which they would find > >>> out how to do stuff in wikimedia git / gerrit. > >>> > >>> Link is here: www.mediawiki.org/wiki/User:Petrb/Git_for_idiots > >>> > >>> It doesn't contain so much and there are some mistakes / feel free to > fix them. > >>> > >>> Since wikimedia switched to gerrit from svn I have yet met a tons of > >>> people who had problems adapting to it, so this could eventually help > >>> some. > >>> > >> > >> We've got [[Git/Workflow]], [[Git/Tutorial]] and [[Git/Getting > >> started]] (in decreasing > >> order of complexity/depth), so I would be hesitant to add yet another > >> howto page. > >> Considering this is supposed to be quick-and-easy docs, I'd suggest > folding any > >> unique content into the getting started doc. > >> > >> -Chad > >> > >> _______________________________________________ > >> Wikitech-l mailing list > >> Wikitech-l@lists.wikimedia.org > >> https://lists.wikimedia.org/mailman/listinfo/wikitech-l > > > > _______________________________________________ > > Wikitech-l mailing list > > Wikitech-l@lists.wikimedia.org > > https://lists.wikimedia.org/mailman/listinfo/wikitech-l > > _______________________________________________ > Wikitech-l mailing list > Wikitech-l@lists.wikimedia.org > https://lists.wikimedia.org/mailman/listinfo/wikitech-l > _______________________________________________ Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
