> Is that material too hard to understand, or too hard to find?
> Or does it take too much time to read?
Easy enough to find; first place I looked.
Too hard to connect the stuff I was reading to the error message I was getting.
I saw things like "git will normalize CRLF to LF", while git itself seems to be warning me that it will normalize in the exact opposite direction, when I'm already committing LF.
> However, as a very first step: "or something along those lines." needs to be defined.
> Which short text would have explained the whole story better?
If the goal here is merely to explain the whole story "better", that is easy.
Add the words "on checkout" somewhere near the end of the existing error message.
> git checkout t.txt (which has LF) in your scenario will not checkout the file with CRLF rigth now.
This shows that "better" is not the same as "perfect".
My suggestion is indeed a bit misleading in that department.
But I think it is less misleading than the current wording.
It doesn't take the user all the way to the final destination, but does point them in the right direction.
The current wording pointed me in the wrong direction.
I think, but obviously can't prove, that if the words "later" or "at checkout" had been in the
error message, it would have been clear enough that I would have eventually figured out what's going
on without having to ask on stack overflow.
> In that sense: Suggestions (the complete new text) of the warning message are welcome.
Okay this is actually kind of hard, since there's a tension between being concise and being precise, or at least not lying too much.
Something like this might be a bit too verbose, but tells only one white lie ("will be converted" should really be "will be converted unless your git settings (git config plus git attributes) change by then"):
warning: t.txt will be committed with LF line endings, but will be converted to CRLF in your working directory the next time this file needs to be checked out.
Until then, it will have keep its LF line endings in your working directory.
Alternatively, here's a less drastic change that's more concise but perhaps still "hand-holdy" enough:
warning: LF will be replaced by CRLF in t.txt the next time this file is checked out.
Until then, it will have keep its LF line endings in your working directory.
I could come up with more variations on this theme but I think you see what I'm trying to gesture at.
Thoughts?
_________________________________________________________________________________________________________________________________________________________________________________________________________________________________
?This message is for information purposes only, it is not a recommendation, advice, offer or solicitation to buy or sell a product or service nor an official confirmation of any transaction. It is directed at persons who are professionals and is not intended for retail customer use. Intended for recipient only. This message is subject to the terms at: www.barclays.com/emaildisclaimer.
For important disclosures, please see: www.barclays.com/salesandtradingdisclaimer regarding market commentary from Barclays Sales and/or Trading, who are active market participants; https://www.investmentbank.barclays.com/disclosures/barclays-global-markets-disclosures.html regarding our standard terms for the Investment Bank of Barclays where we trade with you in principal-to-principal wholesale markets transactions; and in respect of Barclays Research, including disclosures relating to specific issuers, please see http://publicresearch.barclays.com.?
_________________________________________________________________________________________________________________________________________________________________________________________________________________________________
If you are incorporated or operating in Australia, please see https://www.home.barclays/disclosures/importantapacdisclosures.html for important disclosure.
_________________________________________________________________________________________________________________________________________________________________________________________________________________________________
How we use personal information see our privacy notice https://www.investmentbank.barclays.com/disclosures/personalinformationuse.html
_________________________________________________________________________________________________________________________________________________________________________________________________________________________________
