> I think it makes more sense to document it where it's documented now, > i.e. under how "!" works in general, since this is an edge case with > negative matching. My reasoning is/was that while yes, that's true, I think it's likely that the positive matches would be added before (in terms of git history) the exclusions. In other words it may not occur to the user writing an early version of `.gitignore` to think about exclusions if they don't need to exclude anything yet -- the eventual symptoms of this problem may be "far away" from the cause, making it harder to diagnose (I'm living proof of that!) > I think it can certainly be made clearer, but maybe with a practical > example (per above) where we also show the dir structure that > would/wouldn't be matched. > > I just chimed in on this one because your patch says the docs are > "unclear" then "Explain this behavior (and its implications) more > explicitly" without a reference to the existing adjacent docs. I think > whatever we do we should be unifying these docs if they're amended, not > stating this twice. I think my inability to see it despite knowing exactly what I was looking for (this time) makes it "unclear", at least to dummies me, so I feel like that statement is at least somewhat defensible :) If the explanation were unified, would the idiomatic way to do that be to add some section way down the document with a couple of `(see SOME DETAILS ABOUT THIS below)` and some examples in the examples section?
