Re: [Wikitech-l] "Troubleshooting Git/Gerrit/git-review" docs: Help welcome.

2016-05-05 Thread Andre Klapper 
On Wed, 2016-05-04 at 23:28 -0500, Andrew Bogott wrote:
> On 5/4/16 8:59 AM, Andre Klapper wrote:  
> > https://www.mediawiki.org/wiki/Gerrit/Troubleshooting
> 
> Although technically correct, some of those instructions encourage users 
> to use 'git pull.'  Git doc writers, please join me in my crusade to 
> stop gerrit users from ever, ever using 'git pull.'

Please be bold and edit. I'm certainly not an advanced Git user; I just
want the learning curve for new contributors to be less steep.

> Thank you for compiling these docs!

Nah. I just moved, restructured + cleaned up content a bit. :)

If anyone feels like joining the Git/Gerrit doc cleanup efforts: 
I have dumped an incomplete "stuff to do" list in
https://phabricator.wikimedia.org/T134256#2260631 for ideas.
For example, I'd love to kill [[mw:Git/Tips]] + [[mw:Git/Rebase]] as we
already have a Tutorial, an FAQ, Advanced usage, Getting started, ...

Thanks!
andre
-- 
Andre Klapper | Wikimedia Bugwrangler
http://blogs.gnome.org/aklapper/



___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

Re: [Wikitech-l] "Troubleshooting Git/Gerrit/git-review" docs: Help welcome.

2016-05-05 Thread Chad 
On Wed, May 4, 2016 at 9:29 PM Andrew Bogott  wrote:

> On 5/4/16 8:59 AM, Andre Klapper wrote:
> > Hej,
> >
> > I went ahead & centralized the 5 git/Gerrit/git-review troubleshooting
> > sections that I've found so far on random mediawiki.org pages into one
> > single page (and eliminated duplicates with different solutions):
> >
> > https://www.mediawiki.org/wiki/Gerrit/Troubleshooting
> >
> >
> Knee-jerk ahead:
>
> Although technically correct, some of those instructions encourage users
> to use 'git pull.'  Git doc writers, please join me in my crusade to
> stop gerrit users from ever, ever using 'git pull.' There's no end to
> the heartbreak that can result from pulling. Pulling merges, and merging
> is gerrit's job.
>
> https://wikitech.wikimedia.org/wiki/Help:Git_rebase
>
>
`git pull -r` is my favorite :)

-Chad
___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

Re: [Wikitech-l] "Troubleshooting Git/Gerrit/git-review" docs: Help welcome.

2016-05-04 Thread Andrew Bogott 

On 5/4/16 8:59 AM, Andre Klapper wrote:

Hej,

I went ahead & centralized the 5 git/Gerrit/git-review troubleshooting
sections that I've found so far on random mediawiki.org pages into one
single page (and eliminated duplicates with different solutions):
  
https://www.mediawiki.org/wiki/Gerrit/Troubleshooting




Knee-jerk ahead:

Although technically correct, some of those instructions encourage users 
to use 'git pull.'  Git doc writers, please join me in my crusade to 
stop gerrit users from ever, ever using 'git pull.' There's no end to 
the heartbreak that can result from pulling. Pulling merges, and merging 
is gerrit's job.


https://wikitech.wikimedia.org/wiki/Help:Git_rebase



Thanks for your help.
Thank you for compiling these docs!  I will think about how to politely 
introduce the above screed into your new page :)


-A



___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

Re: [Wikitech-l] "Troubleshooting Git/Gerrit/git-review" docs: Help welcome.

2016-05-04 Thread Tony Thomas 
Something I always found missing in
https://www.mediawiki.org/wiki/Gerrit/Tutorial is:

'Amending a change using HTTPS '

Is this documented somewhere ? Usually in campus networks SSH ports are
blocked, and this one is a huge blocker to University Hackathons!

Thanks,
Tony Thomas 
Home  | Blog  |
ThinkFOSS 


On Wed, May 4, 2016 at 9:12 PM, Brad Jorsch (Anomie) 
wrote:

> On Wed, May 4, 2016 at 9:59 AM, Andre Klapper 
> wrote:
>
> > On https://www.mediawiki.org/wiki/Gerrit/Tutorial there is one section
> > called "Pushing via HTTPS when SSH is not functional" which I'd also
> > like to move to [[mw:Gerrit/Troubleshooting]].
> > Anyone knows how users would actually realize that SSH is not
> > functional? (Specific output after a specific command?)
> >
>
> They'd probably realize it when they run any git command that tries to
> communicate with the server and it outputs an error message that refers to
> connecting via ssh, e.g. "ssh: connect to host gerrit.wikimedia.org port
> 29418: Connection refused" or "ssh: connect to host gerrit.wikimedia.org
> port 29418: Network is unreachable" from the command-line git client.
>
> Then they can more directly test that it's ssh with the commands Tony
> Thomas posted.
>
>
> --
> Brad Jorsch (Anomie)
> Senior Software Engineer
> Wikimedia Foundation
> ___
> 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

Re: [Wikitech-l] "Troubleshooting Git/Gerrit/git-review" docs: Help welcome.

2016-05-04 Thread Brad Jorsch (Anomie) 
On Wed, May 4, 2016 at 9:59 AM, Andre Klapper 
wrote:

> On https://www.mediawiki.org/wiki/Gerrit/Tutorial there is one section
> called "Pushing via HTTPS when SSH is not functional" which I'd also
> like to move to [[mw:Gerrit/Troubleshooting]].
> Anyone knows how users would actually realize that SSH is not
> functional? (Specific output after a specific command?)
>

They'd probably realize it when they run any git command that tries to
communicate with the server and it outputs an error message that refers to
connecting via ssh, e.g. "ssh: connect to host gerrit.wikimedia.org port
29418: Connection refused" or "ssh: connect to host gerrit.wikimedia.org
port 29418: Network is unreachable" from the command-line git client.

Then they can more directly test that it's ssh with the commands Tony
Thomas posted.


-- 
Brad Jorsch (Anomie)
Senior Software Engineer
Wikimedia Foundation
___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

Re: [Wikitech-l] "Troubleshooting Git/Gerrit/git-review" docs: Help welcome.

2016-05-04 Thread Tony Thomas 
On Wed, May 4, 2016 at 7:29 PM, Andre Klapper 
wrote:

> Anyone knows how users would actually realize that SSH is not
> functional? (Specific output after a specific command?)
>

They run $ ssh -p 29418 @gerrit.wikimedia.org -v  and would not
get a welcome message!

Simpler method would be $ telnet gerrit.wikimedia.org 29418   and it would
hang up like anything!

Thanks,
Tony Thomas 
Home  | Blog  |
ThinkFOSS 
___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

[Wikitech-l] "Troubleshooting Git/Gerrit/git-review" docs: Help welcome.

2016-05-04 Thread Andre Klapper 
Hej,

I went ahead & centralized the 5 git/Gerrit/git-review troubleshooting
sections that I've found so far on random mediawiki.org pages into one
single page (and eliminated duplicates with different solutions):
 
https://www.mediawiki.org/wiki/Gerrit/Troubleshooting

1) More help is welcome to clean up and structure that page (plain git
vs. git-review vs. Gerrit UI).

2) As a user, I prefer section headings to describe problems instead of
solutions (as I don't know which solution is related to my problem).
On https://www.mediawiki.org/wiki/Gerrit/Tutorial there is one section
called "Pushing via HTTPS when SSH is not functional" which I'd also
like to move to [[mw:Gerrit/Troubleshooting]].
Anyone knows how users would actually realize that SSH is not
functional? (Specific output after a specific command?)
How would Gerrit users realize they are behind a proxy server?

Thanks for your help.

andre
-- 
Andre Klapper | Wikimedia Bugwrangler
http://blogs.gnome.org/aklapper/



___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l