Activity for thesquaregrootâ€
Type | On... | Excerpt | Status | Date |
---|---|---|---|---|
Edit | Post #26376 | Initial revision | — | about 5 years ago |
Edit | Post #26365 | Initial revision | — | about 5 years ago |
Edit | Post #26306 | Initial revision | — | about 5 years ago |
Edit | Post #26097 | Initial revision | — | about 5 years ago |
Answer | — |
A: How can I make a case for toning down the "rah rah" marketing tone around technical content? This is tough. I tend to have what a view that I think is fairly close to yours and I think it's often difficult to argue for more accuracy without coming across as pedantic. I think that are a couple of realizations that helped me with this, though. Being deceptive is bad, being vague is okay. As... (more) |
— | almost 7 years ago |
Answer | — |
A: Alternatives better to the binary "0b..." format? As somewhat alluded to by Chenmunka, if your documentation is generally in the context of a specific programming language and/or compiler, it is probably best to stick to what is required by those. However, I think this is also somewhat dependent on why the numbers are appearing in your documentation... (more) |
— | almost 7 years ago |
Question | — |
Bridging the gap between colloquial usage and technical meaning of terms Frequently, at least in the software world, it seems that terms get assigned a meaning over time that is more general than the original definition. REST is a good example of this. While REST refers to a specific way to architect web services, it has become associated with popular styles of making sim... (more) |
— | almost 7 years ago |
Question | — |
How do you explain the details of something technical to a non-technical audience? When writing about technical topics it is often difficult to get across the complexity of a topic without getting "stuck in the weeds" and ultimately leaving the audience confused or disinterested. Particularly when the audience lacks the necessary background to explain the topic in it's own terms (e... (more) |
— | almost 7 years ago |