git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [RFC/PATCH] Triangular Workflow UI improvement: Documentation

From
Matthieu Moy <matthieu.moy@grenoble-inp.fr>
Date
Jun 6, 2016, 07:58 UTC
Message-ID
<vpq7fe2rbno.fsf@anie.imag.fr>
In-Reply-To
<F57B7CD2-8F8B-4D58-B145-285E69F9B4BE@grenoble-inp.org>
Jordan DE GEA <jordan.de-gea@grenoble-inp.org> writes:
Show 23 quoted lines
>> Matthieu Moy <matthieu.moy@grenoble-inp.fr> a écrit :
>> 
>> That is technically correct, but to illustrate the overall flow, I'd
>> rather avoid naming the repositories in terms of git commands. If you do
>> so, you will probably end up with tautological explanations like this
>> later in the text: "FETCH_REMOTE is the remote from where you fetch,
>> PUSH_REMOTE is the remote to which you push, and LOCAL is local".
>> 
>> I suggested PUBLIC-FORK earlier, and didn't get any feedback on it. I
>> think it translates the intent better than PUSH_REMOTE. An alternative
>> would be PUBLISH (= the repository you use to publish your changes so
>> that the maintainer can pick them).
>
>> "Philip Oakley" <philipoakley@iee.org> writes:
>> However your gitster/git repo feels like it would match the me/git
>> viewpoint, in that while it is 'open', it isn't really a formal
>> publishing place. Certainly I don't think that I 'publish' what's in
>> my personal github repos, which I use as an open backup (and any
>> PR's I put to the G4W project repo are referenced from there).
>
>
> For Philip Oakley, PUBLISH seems to not be a good name. 
> For PUBLIC-FORK, a fork can be private so I think that’s not a good idea. 

I don't think you will find a name that fits all use-cases. IHMO, best is to pick one rather general use-case, make the explanations for it, and maybe explain somewhere that there are variants.

If the fork is completely private, then your diagram with a "maintainer" arrow from it to upstream is not valid. It needs at least to be visible to the maintainer. "public" may be a bit strong as you don't need to make it "public" to everyone on earth, but to me that's OK to describe the use-case.

> As the third-place is the repository used to work on commits/patches, 
> a simple name can be WORK_REPOSITORY.

"WORK" is already used to describe "worktree" which is precisely not this repository. I don't "work" on my public fork, I "work" locally and then just send commits there.

-- 
Matthieu Moy
http://www-verimag.imag.fr/~moy/
Previous: Jordan DE GEANext: Philip Oakley
Message 16 of 41 in “[RFC] Triangular Workflow: user friendly full implementation”
  1. Jordan DE GEAMay 26, 2016
  2. Matthieu MoyMay 26, 2016
  3. Junio C HamanoMay 26, 2016
  4. [RFC] Triangular Workflow UI improvementJordan DE GEA, May 30, 2016
  5. Philip OakleyMay 27, 2016
  6. [RFC] Triangular Workflow UI improvmentsJordan DE GEA, May 30, 2016
  7. Triangular Workflow UI improvement: DocumentationJordan DE GEA, May 31, 2016
  8. Matthieu MoyMay 31, 2016
  9. Jordan DE GEAJun 1, 2016
  10. Michael HaggertyJun 2, 2016
  11. Philip OakleyJun 3, 2016
  12. Jordan DE GEAJun 3, 2016
  13. Matthieu MoyJun 3, 2016
  14. Jordan DE GEAJun 3, 2016
  15. Jordan DE GEAJun 5, 2016
  16. Matthieu MoyJun 6, 2016
  17. Philip OakleyJun 6, 2016
  18. Matthieu MoyJun 6, 2016
  19. Philip OakleyJun 6, 2016
  20. Matthieu MoyJun 7, 2016
  21. Philip OakleyJun 7, 2016
  22. Junio C HamanoJun 3, 2016
  23. Philip OakleyJun 3, 2016
  24. [RFC/PATCHv2] Documentation: triangular workflowJordan DE GEA, Jun 6, 2016
  25. Junio C HamanoJun 6, 2016
  26. Philip OakleyJun 6, 2016
  27. Matthieu MoyJun 7, 2016
  28. Jordan DE GEAJun 7, 2016
  29. [PATCHv3] Documentation: triangular workflowJordan DE GEA, Jun 7, 2016
  30. Junio C HamanoJun 7, 2016
  31. Jordan DE GEAJun 8, 2016
  32. Matthieu MoyJun 8, 2016
  33. [PATCHv4] Documentation: triangular workflowJordan DE GEA, Jun 9, 2016
  34. Junio C HamanoJun 9, 2016
  35. Ramkumar RamachandraJun 11, 2016
  36. Philip OakleyJun 11, 2016
  37. Philip OakleyJun 9, 2016
  38. Junio C HamanoJun 10, 2016
  39. Philip OakleyJun 11, 2016
  40. Junio C HamanoJun 13, 2016
  41. [RFC] Triangular Workflow UI improvementJordan DE GEA, May 30, 2016

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.