[CentralOH] Help with doing git pull requests on a Python project

[jep200404 at columbus.rr.com]

On Sun, 15 Mar 2015 12:50:18 -0400, pybokeh <pybokeh at gmail.com> wrote:

> I took a basic git/github class a while back, but I'm still struggling.  I
> only know how to create my own repositories locally and at github and push
> changes to them and raise issues.  But that's about it since I don't really
> create code that would be used by others and my level of Python is not that
> great to be able to contribute to the actual source code of Python
> projects.  However, I can contribute at least by improving documentation.

Contributing to documentation is the classic beginning for 
open-source software.

> I want to improve documentation of a Python project and was wondering if
> someone could meet me at this week's upcoming dojo meeting this Friday or I
> can meet at other times of the week.  Coffee, tea, or snacks on me.

I can help then with the github part. 
(Others are welcome. I'll learn from them.)

> I was provided this link on how to contribute to this particular project
> ("pandas"):
> https://github.com/pydata/pandas/wiki/Contributing
> 
> and that's where things got confusing for me and need help with.

It seems that the pandas folks are picky about what you 
issue a pull request of, in wanting the rebased stuff. 
I have used the rebase command. It is intimidating at first. 
I found the dox at git-scm.com/book/en/v2/Git-Branching-Rebasing 
to be good. Practice on a sacrificial copy of a repo. 

Perhaps the dox to improve first are those about how to contribute.

Separately, for contributing to Python itself (not just a project 
that uses Python), there are mentors for that, and I am not 
one of them. 

By the way, the 2014-08-15 scribbles have notes for setting 
up a git server. Ever listen to Car Talk?

    diner at dojo:~$ mkdir dk-diner
    diner at dojo:~$ cd dk-diner
    diner at dojo:~/dk-diner$ git clone git://github.com/pydata/pandas
    Cloning into 'pandas'...
    remote: Counting objects: 81769, done.
    remote: Compressing objects: 100% (21/21), done.
    remote: Total 81769 (delta 7), reused 0 (delta 0), pack-reused 81748
    Receiving objects: 100% (81769/81769), 46.56 MiB | 910.00 KiB/s, done.
    Resolving deltas: 100% (66997/66997), done.
    Checking connectivity... done.
    diner at dojo:~/dk-diner$ git remote -v
    fatal: Not a git repository (or any of the parent directories): .git
    diner at dojo:~/dk-diner$ cd pandas/
    diner at dojo:~/dk-diner/pandas$ git remote -v
    origin  git://github.com/pydata/pandas (fetch)
    origin  git://github.com/pydata/pandas (push)
    diner at dojo:~/dk-diner/pandas$ git remote add upstream git://github.com/pydata/pandas
    diner at dojo:~/dk-diner/pandas$ git remote -v
    origin  git://github.com/pydata/pandas (fetch)
    origin  git://github.com/pydata/pandas (push)
    upstream        git://github.com/pydata/pandas (fetch)
    upstream        git://github.com/pydata/pandas (push)
    diner at dojo:~/dk-diner/pandas$