Re: Making git disappear when talking about my code

Carl Worth <cworth@cworth.org> writes:

Why would you want to add another syntax that can talk about only one branch? It shows that you care only about talking about single branch, making things harder for other people who might want to talk about two branches or more.

I would agree with you that if you are talking to total git newbie, you cannot get away with message like [3] in your original and you would need some instructions you added in your example [2]. But I suspect that is true for any new system. If somebody has never seen cvs and your project is hosted at cvs, and if you want to be really helpful, I think you have to tell "cvs -d :pserver:... co cworth-project" somewhere in your message.

But that does not have to be in the main part of the announcement, like this (this is your [2]):

    I've just written some very fancy feature for our cool project
    which you can see in gitweb at <gitweburl>. To track this
    branch, do "git remote add cworth <url>; git checkout --track
    -b <branch> cworth/<branch>" if you already have some clone of
    our project. Otherwise do "git clone <url>; git checkout
    --track -b <branch>". Please try it out and give me feedback.

You can say instead:

    I've just written some very fancy feature for our cool project
    which is available in the <branch> branch at <url>. Please try
    it out and give me feedback. [*1*]

    [Footnote]

    *1* If you have never used git, here are the ways to get at
        the cool project ...

	 <<< instruction here >>>

	If you have been tracking the upstream of the cool
	project, alternatively you can do this to get to my
	fancy feature as a new branch in your repository ...

	 <<< instruction here >>>