| ▲ | ivanjermakov 4 days ago |
| > We can elucidate our woes by conjuring some contrived Rust code I need to work on my English vocabulary.. |
|
| ▲ | ggambetta 3 days ago | parent | next [-] |
| No. Good technical writing is about making the reader feel smart, not the writer. Using big words goes in the opposite direction. The real art is in explaining complex ideas in simple terms. |
| |
| ▲ | MathMonkeyMan 2 days ago | parent | next [-] | | I think the idea is that the sentence introduces a contrived example, and so the author used roundabout words. Snake sentences sound sibilantly. It's a blog post. | |
| ▲ | em-bee 3 days ago | parent | prev [-] | | but i think i understand the sentence, and so reading it makes me feel very smart ;-) |
|
|
| ▲ | thunderseethe 3 days ago | parent | prev | next [-] |
| That ones on me. I blog as a way to practice writing, and right now I'm working on picking more interesting verbs. I have a usage of `proselytize` later on that is outright smarmy. |
| |
| ▲ | senderista 3 days ago | parent | next [-] | | Related nitpick: “maxima” is the plural form, “maximum” is the singular. | |
| ▲ | macgyverismo 3 days ago | parent | prev | next [-] | | The comment in your frobulate code suggests one is to forbulate, yet reading The code it is very clear that there will only be frobulation happening in the outlined proceedings. Perhaps a minor revision is required. | |
| ▲ | ggambetta 3 days ago | parent | prev [-] | | Since you care about the quality of your writing: you almost certainly meant "one's" or "one is", not "ones". "Outright smarmy" is spicy, I give you that :) |
|
|
| ▲ | 3 days ago | parent | prev [-] |
| [deleted] |
