You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@juneau.apache.org by David Goddard <go...@acm.org> on 2017/06/01 14:44:23 UTC
A tale of two repositories
Reading back through the Sample Codes on Documents thread, and looking
at the pull request emails originating from the bot
(git@git.apache.org), it looks like there is some process that may take
a completed pull request in the Github mirror and then apply it to the
primary repository. Maybe. The mechanics of the relationship between
the Github and main repositories are a little unclear to me, other than
that there is obviously a link held both between the two repositories
and the user IDs of committers on the two systems, and it seems to 'just
work'.
Either way, using a pull request on the Github mirror seems to provide a
useful medium for discussing a proposed code change regardless of
whether it is coming from a committer or not. However, this would mean
syncing your dev environment against potentially two different
repository servers, depending on whether you wish to make use of the
Github functionality or not for a given code change. There are also two
different ways of working depending on which you are using: on Github
you can work with a fork, while on the primary server you'd have to use
branches (which may or may not be pushed back to the origin).
The Contributing for Non-committers document makes sense in the context
in which it is intended, but I feel there is some missing information on
the underlying process and best practice workflows (unless of course I
am failing to understand something that is so obvious it's been left
unstated, which would not be the first time...)
David (very much a Git novice)
On 01/06/2017 15:29, James Bognar wrote:
> On Thu, Jun 1, 2017 at 7:28 AM, David Goddard <go...@acm.org> wrote:
>
>> The guide to contributing for non-commiters (https://cwiki.apache.org/conf
>> luence/display/JUNEAU/Contributing+for+Non-committers) instructs the user
>> to create their own fork of the *mirrored* repo (
>> https://github.com/apache/incubator-juneau), apply any changes to their
>> fork, and then create a pull request.
>
> Good question. I don't know the answer on that. It sounds like we should
> be instructing non-committers to use the 'real' git repo.
>