Christian Couder <christian.couder@xxxxxxxxx> writes: > > I think sometimes the details might be interesting for different reasons. > ... > With the details, I think readers are more likely to remember the > --merges option. That unfortunately cuts both ways. With too much details, the readers are more likely to skim and skip the "--merges" buried in reams of text. Only the ones who carefully read from cover to cover would discover and contrast the first iteration "sed" with the second iteration "--merges", but I'd expect that they would also be the ones who carefully read the docs and more likely to know about "--merges" without Rev News teaching them. Used sparingly, the details do pull interested readers in. The key word in your message was "sometimes", I think. -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html