You’ll be fine. Promise. ;)
Apache CouchDB is the project I’m most familiar with—in general, and in this specific case. It accepts GitHub pull requests, has a git repo at the ASF, uses Jira for issues, Confluence for the wiki, and ReadTheDocs for publishing their documentation. Here’s the list of their GitHub mirrors: https://github.com/apache?query=couchdb Specifically, you can see how this works for Fauxton (more or less a sub-project; the UI shipped with CouchDB 2.x): https://github.com/apache/couchdb-fauxton/blob/master/CONTRIBUTING.md#guide-to-contributions It’s just like any PR flow with the addition that if there’s a Jira issue, referencing it is a huge help to everyone. There’s also some additional info on the general shape of an Apache project within the CouchDB Bylaws document (which I intend for us to copy/crib ;) ): http://couchdb.apache.org/bylaws.html Additionally, their code of conduct is also quite good and now used (more or less exactly) by the ASF: http://couchdb.apache.org/conduct.html https://www.apache.org/foundation/policies/conduct (technically, we probably don’t need our own anymore) Let me know if there are key things you’re unhappy about, and I’ll see (with the help of the Mentors) what we can do to help simplify things. Cheers, Benjamin -- http://bigbluehat.com/ http://linkedin.com/in/benjaminyoung From: Robert Knight<mailto:[email protected]> Sent: Wednesday, October 19, 2016 7:07 AM To: [email protected]<mailto:[email protected]> Cc: Benjamin Young<mailto:[email protected]>; Amanda Visconti<mailto:[email protected]>; Nick Kew<mailto:[email protected]> Subject: Re: Things we need > Additionally, the ASF has (ultimately) legal responsibility over the > authority and access of the code and content it (through us) produces. > Even pull-requests accepted for Apache projects via GitHub still go through > the same CLA processes before getting merged into the ASF-level git repository >—which is then synchronized back to GitHub. The GitHub mirrors are there >mostly for findability, afiak. :) Can you point to a few examples of Apache projects that use GitHub effectively? If working with projects under the Apache banner through GitHub is at all cumbersome then that would hugely devalue it for me. On Tue, Oct 18, 2016 at 7:47 PM, Randall Leeds <[email protected]> wrote: > Thank you, Benjamin, for a much more clear and helpful response than mine! > > On Tue, Oct 18, 2016, 11:44 Benjamin Young <[email protected]> wrote: > >> Amanda (et al), >> >> >> >> Here’s a great guide to git-svn: >> >> https://git-scm.com/book/en/v1/Git-and-Other-Systems-Git-and-Subversion >> >> >> >> It is another thing to learn (sorry about that), but the SVN setup >> (especially for web site stuff) is pretty deeply baked into the >> infrastructure of the ASF. >> >> >> >> Additionally, the ASF has (ultimately) legal responsibility over the >> authority and access of the code and content it (through us) produces. Even >> pull-requests accepted for Apache projects via GitHub still go through the >> same CLA processes before getting merged into the ASF-level git >> repository—which is then synchronized back to GitHub. The GitHub mirrors >> are there mostly for findability, afiak. :) >> >> >> >> We will have a git repo for our code. >> >> The svn repo is needed only for the web site, and hopefully git-svn will >> help ease folks into using it—but SVN’s pretty easy to learn (especially >> for web site stuff). Tools like this make it even simpler: >> https://tortoisesvn.net/ >> >> >> >> Let me know if you need help along the way! >> >> Benjamin >> >> -- >> http://bigbluehat.com/ >> http://linkedin.com/in/benjaminyoung >> >> >> >> *From: *Randall Leeds <[email protected]> >> *Sent: *Tuesday, October 18, 2016 12:23 PM >> *To: *Amanda Visconti <[email protected]>; Benjamin Young >> <[email protected]> >> *Cc: *[email protected]; Nick Kew <[email protected]> >> *Subject: *Re: Things we need >> >> >> >> ASF will host a static site in svn so it's similar to GH Pages in that >> sense. >> >> You can use git-svn if you'd rather use git to interact with the repo. >> >> For the non-www project code, we will get a git repo and not svn at all, >> though as I understand it the publishing hooks infra has set up for the web >> site rely on us storing those assets in the appropriate SVN repo. >> >> One can even add two git remotes, one for code and one for git-svn, and >> have a workflow just like a master/gh-pages branches. >> >> On Tue, Oct 18, 2016, 09:10 Amanda Visconti <[email protected]> >> wrote: >> >> Thanks for this! I'd be willing to own the website, though I'm more >> comfortable with git than svn. That would also let us host the site via >> GitHub Pages, which I've found useful in the past (though maybe there are >> downsides to GH Pages for a project like this that I haven't thought of?). >> Best, >> Amanda >> >> On Tue, Oct 18, 2016 at 9:58 AM, Benjamin Young <[email protected]> >> wrote: >> >> Hi all! (CC’d people I mention directly) >> >> >> >> That clock thing keeps spinning round and round (somewhat influenced by >> the rotational habits of the planet…I’m guessing…). Consequently, we’ve got >> some items to tackle before our next Incubator report. >> >> >> >> Here’s the list in my head—please extend it as needed! >> >> >> >> Web Site >> >> - pending a URL fix (Nick’s got this, I think) >> >> - SVN repo is here: >> https://svn.apache.org/repos/asf/incubator/annotator/ >> >> - Current site looks like this: >> https://svn.apache.org/repos/asf/incubator/annotator/site/index.html >> >> - Needs: >> >> o Determine if we keep the old site (can we copyright/license-wise)? >> Randall? >> >> o Someone to “own” this bit. Amanda? >> >> >> >> Code >> >> - Repo? Is this it? >> https://svn.apache.org/repos/asf/incubator/annotator/ >> >> o Do we just make additional directories (trunk, branch, etc) there? >> >> o That’s how Streams does it: >> https://svn.apache.org/repos/asf/incubator/streams/ >> >> - Plan. :) Randall, you want to lead the charge on that? >> >> o Do we continue with the Annotator.js code base? >> >> o Smaller bit based on Randall’s work? >> >> o Do we also want server side code now/yet/soon? /me has some. >> >> >> >> Wiki >> >> - Confluence? Nick? Randall? >> >> >> >> Issues >> >> - Can we use GitHub issues for that? Nick? >> >> >> >> That’s certainly not all we need to do here, but it’s what’s been buzzing >> in my brain, so I’m sharing it. :) >> >> >> >> Additions more than welcome! >> >> Benjamin >> >> >> >> -- >> http://bigbluehat.com/ >> http://linkedin.com/in/benjaminyoung >> >> >> >> >> -- Kind Regards, Rob
