3 ms·

Show, don't tell.

• jackmaney 12y ago
  But if you're going to tell, be concise and coherent.
  • nocman 12y ago
    Yes, 1000 times yes! I know the author has a lot to say, but even after patiently wading through the first few paragraphs I was not prepared to invest any more time in figuring out what was so great about this project. The article title was enough to get my attention, but I could not hang in there long enough to get excited about (or even remain mildly interested in) the project. Edit: OK, it was probably more like 50-60% of the first page that I read through, not just the first few paragraphs.
• blakeyrat 12y ago
  It mostly reminded me of Spolsky: http://www.joelonsoftware.com/articles/fog0000000018.html http://www.joelonsoftware.com/articles/fog0000000018.html > That's one sure tip-off to the fact that you're being assaulted by an Architecture Astronaut: the incredible amount of bombast; the heroic, utopian grandiloquence; the boastfulness; the complete lack of reality. And people buy it! The business press goes wild!
• teacup50 12y ago
  Unless you're trying to be precise and detailed (as opposed to spewing startup advertising), in which case "tell" is exactly what you should be doing.