Volunteer github guru for documentation submissions?

Alex Tweedly alex at tweedly.net
Wed Apr 13 18:44:07 EDT 2016



On 13/04/2016 22:45, Monte Goulding wrote:
> GitHub <> git and you are using GitHub which has hacked on a web interface for working on stuff. I honestly think that if folks spent the same amount of time working out the web interface as working out how to use git locally using a good git gui then they would be finding things much simpler. The main issue is locally you need to actively switch branches so you always know where you are but on the web it is much easier to jump between branches and get confused.
Monte, I'm probably just caffeine-deprived, but I have trouble parsing 
that first sentence.
I *think* you're recommending using a git gui, and not using the web 
interface - but it could be just the inverse.

Which do you recommend?
If it's a git gui - any favourite(s) ?

Being old-fashioned, I started with the command-line interface :-) But 
even then, Ali's document switched into the web interface at a couple of 
crucial points.

I do think there are some errors or omissions in the "git gui" section 
of his document, but I don't know enough to be sure, far less to fix 
them ....

For example
>
> Make sure both the docs change and the bugfix note are ready for 
> commit in the GUI client.
>
> In the summary and description section,
>
> The title should be along the lines of
>

and later ...
>
> Click commit to
>
> Then click "Submit pull request"
>

> There is a way for others to work on things together and given that’s the point of git that’s a good thing! The way to do it is to go to your patch-4 branch, edit and then submit a PR to you which you then incorporate and which would reflect the changes in your PR. In the past I have sent PRs to branches on other people’s forks on the team and had team members send PRs to my branches that I have had in review.
>
What's a "patch-4 branch" ?
I've only got as far as submitting a couple of trivial changes - but I'm 
pretty sure I didn't have a patch-4 branch ?


-- Alex.
P.S. I'm really struggling to avoid being a grumpy old man and saying 
"it's all been downhill since we switched from SCCS to RCS" :-)




More information about the use-livecode mailing list