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 innocentkiller@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 benapetr@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 innocentkiller@gmail.com wrote:
On Wed, May 8, 2013 at 12:34 PM, Petr Bena benapetr@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