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%C2%A0there 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
On Wed, May 4, 2016 at 7:29 PM, Andre Klapper aklapper@wikimedia.org wrote:
Anyone knows how users would actually realize that SSH is not functional? (Specific output after a specific command?)
They run $ ssh -p 29418 <username>@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 https://www.mediawiki.org/wiki/User:01tonythomas Home http://www.thomastony.me | Blog http://blog.thomastony.me | ThinkFOSS http://www.thinkfoss.com
On Wed, May 4, 2016 at 9:59 AM, Andre Klapper aklapper@wikimedia.org 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.
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 https://www.mediawiki.org/wiki/User:01tonythomas Home http://www.thomastony.me | Blog http://blog.thomastony.me | ThinkFOSS http://www.thinkfoss.com
On Wed, May 4, 2016 at 9:12 PM, Brad Jorsch (Anomie) bjorsch@wikimedia.org wrote:
On Wed, May 4, 2016 at 9:59 AM, Andre Klapper aklapper@wikimedia.org 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
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):
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
On Wed, May 4, 2016 at 9:29 PM Andrew Bogott abogott@wikimedia.org 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):
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.
`git pull -r` is my favorite :)
-Chad
On Wed, 2016-05-04 at 23:28 -0500, Andrew Bogott wrote:
On 5/4/16 8:59 AM, Andre Klapper wrote:
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%C2%A0for 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
wikitech-l@lists.wikimedia.org