-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 6/29/2013 10:08 PM, Sebastian Kuzminsky wrote: > On 06/29/2013 05:15 PM, Charles Steinkuehler wrote: >> >> Basically, I don't care what happens as long as it is clear (ie: >> listed plainly wherever folks are pointed to git.linuxcnc.org to >> grab the code) what someone should do if they wish to modify the >> source and share their changes with others. This could be as >> simple as a statement that it is OK to clone the git repo to >> github or bitbucket or where-ever, a separate git area with open >> push access (chaos.linuxcnc.org, or perhaps "here_be_dragons"!), >> or some other option I haven't thought of. > > I think you're describing the same problem that Peter Jensen > described at the Hackfest. I think you're both saying that it's > unclear how to contribute to the LinuxCNC project. (Well, i think > Peter doesn't think it's unclear any more, but maybe other people > do that I don't know about.) > > I pointed Peter at the Wiki page describing exactly this: > http://wiki.linuxcnc.org/cgi-bin/wiki.pl?Git > > I think it was Jeff Epler who wrote that, back in... I don't > remember when. But the earliest revision that our Wiki remembers > is rev 34, from March 2011. So it's been around for a while. > > We could probably talk about whether that page is as clear as it > could be, or as easy to find as it could be, or as detailed as it > could be.... But it's there, and i think it describes fairly > clearly how to communicate contributions back to the LinuxCNC > project.
OK, I've seen that page a few times, and basically ignored it as it mostly reads as "How to Use git for Newbies 101" which I didn't need. Reading through it a bit more this time since you pointed me at the link, I notice section 7.8 is "Push changes to your own public repository". IMHO, this needs to be a *LOT* more front-and-center promoted that it is perfectly acceptable to clone git.linuxcnc.org on github, play with it a while, and post to the dev list when you have something for others to try. ...and even this is sort-of iffy. It doesn't exactly _encourage_ you to clone git.linuxcnc.org on github/gitorious/bitbucket, it just mentions that it's possible. And it's definitely "buried" on a page I wouldn't expect anyone to be reading carefully if they had any prior experience with git. IMHO, there should probably be at least two pages crafted from the one existing git page. One with the "install git on your system" type details, and one with the "follow the style of the surrounding code" and the "push changes to your own public repository" stuff. ...or maybe I'm just exceptionally dense and didn't RTFM (I'm sure at least one of those applies :) . > I think the system we describe on that Wiki page is very much the > standard way things are generally done in the open source world: > Anonymously clone our public git repo, then send us commits in the > form of email or a pull request from your public repo (which may be > hosted on one of the free git-hosting sites, or on your private > server, it doesn't matter). For example, this is how the GM6 > driver was contributed back (via github), and i think that process > worked very smoothly. Yes, and that's why I think the simplest solution to this is to place some text on the download page (and anywhere else on linuxcnc.org where git.linuxcnc.org is referred to as where to get the source code): http://www.linuxcnc.org/index.php/english/download ...in the "Source code" paragraph that says something like "feel free to clone to a publicly visible repository (ie: github/gitorious/bitbucket) to share your changes and submit pull requests". - -- Charles Steinkuehler char...@steinkuehler.net -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (MingW32) Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iEYEARECAAYFAlHPsBoACgkQLywbqEHdNFxrfwCfTopb04G8iZi/d/jinCUUe+cb eZYAn3cXrkG2C8WBLOxxkfzTYA78Fkp4 =1dK0 -----END PGP SIGNATURE----- ------------------------------------------------------------------------------ This SF.net email is sponsored by Windows: Build for Windows Store. http://p.sf.net/sfu/windows-dev2dev _______________________________________________ Emc-developers mailing list Emc-developers@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/emc-developers
