[libreoffice-documentation] Windows users and git/gerrit

2015-12-06 Thread C
The recent challenges that Peter has faced with git and gerrit has got
me to thinking about how we can go about providing better guidance for
Windows users.

As has been noted in the other discussion, the instructions for
anything related to contributing is very Linux oriented (for many
reasons). The CygWin option is also a bit of a vertical leap. There
are however many Windows oriented solutions for git and even gerrit
that could maybe simplify things.  For example, has anyone here tested
or tried using TortoiseGit? (still CLI involved, but within an easier
to use container)

I'm currently in a situation where I only have Linux on all computers
(I do have one computer with a Windows VM that I use for testing, but
it's unavailable right now), so I cannot poke around for a reasonable
solution to the challenges Peter is struggling with.

In the long term, the WIkiHelp solution will vastly simplify this
contribution hurdle, but it's not yet ready.  In the mean time... how
can we better help Peter and others who are nervous or unfamiliar with
command line?

Maybe this... 
https://git-extensions-documentation.readthedocs.org/en/latest/getting_started.html
(suggested by Beluga in IRC). Other options? Ideas?

Clayton

-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted


[libreoffice-documentation] Re: Use of "allow to" in documentation

2015-12-06 Thread ptoye
Hi Jan,

I read through the pages on gerrit setup (two of them - they seem to be very 
similar to start with, and I fond that  bit confusing!), and started to get 
onto the gerrit system. Then I found that the commands to use gerrit were 
totally Unix-oriented so asked on IRC and was pointed to the LO development on 
Windows wiki page, which implies that I have to install cygwin. Is this 
necessary just for gerrit registration? I won't be building LO itself, just 
editing the help files.

Best regards,

Peter
mailto:l...@ptoye.com
www.ptoye.com

-
Thursday, December 3, 2015, 8:12:47 PM, you wrote:


Hi Peter, 

Peter Toye píše v St 02. 12. 2015 v 16:13 +: 

> OK, when I have time I'll fix the wiki, That's the easy bit. 

Cool, thanks! :-) 

> For the help files, I already have a Git system on my PC (used with 
> Visual Studio Express), but don't know Gerrit at all. I'll read 
> through the documentation on how Git is used for the help files, but I 
> think I'll need help on Gerrit. It won't be for a few days. 

I see.  gerrit is (just) a review system; in other words, a system that 
allows everybody to have write access - you can commit and push your 
changes (to gerrit), where somebody with the appropriate rights will 
read your change, and either comment on that (so that you know what to 
fix), or will merge it to the main git. 

You need to do a bit of a setup: 

https://wiki.documentfoundation.org/Development/gerrit/setup

but then for your work, you'll push very similarly as with the normal 
git. 

>  I don't have an IRC client (or does WIndows 7 have one built-in - 
> I've not found it?) so that will be the first thing. What timezone are 
> you in - your name implies the Central European time zone - UTC+1, so 
> it shouldn't be too difficult to find a time that we're both awake. 

Better if you have an IRC client, but if not, you can join via web too: 

https://webchat.freenode.net/

Join the #libreoffice-dev channel, I'm sure you'll find many people who 
will be able to help you with the gerrit setup, if I'm not around or not 
responding from some reason (I'm "kendy" there). 

All the best, 
Kendy 


-- 
To unsubscribe e-mail to: [hidden email] 
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted 



If you reply to this email, your message will be added to the discussion below:
http://nabble.documentfoundation.org/Use-of-allow-to-in-documentation-tp4167829p4168222.html
To unsubscribe from Use of "allow to" in documentation, click here.
NAML



-
Peter
--
View this message in context: 
http://nabble.documentfoundation.org/Use-of-allow-to-in-documentation-tp4167829p4168465.html
Sent from the Documentation mailing list archive at Nabble.com.
-- 
To unsubscribe e-mail to: documentation+unsubscr...@global.libreoffice.org
Problems? http://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: http://wiki.documentfoundation.org/Netiquette
List archive: http://listarchives.libreoffice.org/global/documentation/
All messages sent to this list will be publicly archived and cannot be deleted