Christian Couder <christian.cou...@gmail.com> 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 majord...@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Reply via email to