{"thread":{"id":"54899","subject":"suggestion for git glossary: upstream, downstream","startedAt":"2020-12-29T13:23:00Z","lastAt":"2021-01-04T23:58:34Z","messageCount":2,"participants":["Steve Summit","Junio C Hamano"],"isPatch":false,"patchVersion":null,"patchTotal":null},"messages":[{"id":"413127","messageId":"2020Dec29.0815.scs.0001@quinine2.home","threadId":"54899","inReplyTo":null,"subject":"suggestion for git glossary: upstream, downstream","fromName":"Steve Summit","fromEmail":"scs@eskimo.com","sentAt":"2020-12-29T13:15:56Z","receivedAt":"2020-12-29T13:23:00Z","isPatch":false,"sender":{"key":"scs@eskimo.com","avatar":null},"body":"The terms \"upstream\" and \"downstream\" are heavily used in much\nwriting about git, with obvious meanings and implications for\nthose who use git regularly, but they're not defined at\nhttps://git-scm.com/docs/gitglossary .  Perhaps they should be?\n(Sorry, I'm not nearly experienced enough with git yet to write\ngood definitions myself, though.)\n"},{"id":"413411","messageId":"xmqqwnws1ci9.fsf@gitster.c.googlers.com","threadId":"54899","inReplyTo":"2020Dec29.0815.scs.0001@quinine2.home","subject":"Re: suggestion for git glossary: upstream, downstream","fromName":"Junio C Hamano","fromEmail":"gitster@pobox.com","sentAt":"2021-01-04T23:57:34Z","receivedAt":"2021-01-04T23:58:34Z","isPatch":false,"sender":{"key":"gitster@pobox.com","avatar":"https://avatars.githubusercontent.com/u/54884?v=4"},"body":"scs@eskimo.com (Steve Summit) writes:\n\n> The terms \"upstream\" and \"downstream\" are heavily used in much\n> writing about git, with obvious meanings and implications for\n> those who use git regularly, but they're not defined at\n> https://git-scm.com/docs/gitglossary .  Perhaps they should be?\n> (Sorry, I'm not nearly experienced enough with git yet to write\n> good definitions myself, though.)\n\nYup, 'upstream' has clear definition and we use the phrase a lot.\n'downstream', not that much, primarily because your repository may\nhave its upstream (singular) but typically you may not even know the\nset of people who consider your repository their upstream.\n\nHaving said that, there isn't much we can actually say about\n'upstream' as a unversal truth, no?  I can readily think of this:\n\n    Your upstream is the line(s) of history you base your\n    development on.\n\nbut beyond that, there aren't much that is common across different\nworkflows how 'upstream' appears to you.  Sometimes you may ask your\nchanges to be pulled by it, sometimes you may directly push into it\nwhile others like you who consider it their upstream do the same.\n\nSo...\n"}]}