2 ms·
[Meta] The introduction to the article relies on so much context and assumed knowledge that I almost didn't read past the third paragraph. Who are Uncle Bob,
by gwbas1c 6y ago
[Meta]
The introduction to the article relies on so much context and assumed knowledge that I almost didn't read past the third paragraph.
Who are Uncle Bob, Gary Bernhardt, and Mr. Brandon Rhodes? I have no idea, and I don't need to know who they are to read the rest of the article. (Which itself is extremely well-written.)
IMO: Have an introduction that doesn't rely on unneeded context. It's appropriate to credit people; but do it in a way where a reader unfamiliar with the context doesn't assume that they need to know the context to read further.
- mac01021 6y agoThe author could stand to flip the sentences around a bit, but the introduction is basically trying to say "these three thoughtful guys collectively formulated some useful ideas about software architecture and in this post I will present those ideas". It is important too attribute ideas to their originators (or at least the source from which one has learned them) and it is good that the OP is doing that. I agree it could have been done a little more gracefully, though, with just a minor tweak to use phrasing that doesn't seem to assume the reader is familiar with those dudes.