mpweiher: "Show me your flowchart and conceal your tables, and I shall continue to be mystified. Show me your tables, and I won't usually need your flowchart; it'll be obvious."
Fred Brooks, The Mythical Man Month
If I understand the problem your code solves, then I can probably understand the words you use to describe the solution to that problem and therefore understand the steps your code takes to implement that solution.
Documentation is underrated.
A well documented codebase is one that doesn't tell you what the code does (the code tells you what the code does in minute detail) but tells you the problem and the solution the code is solving. Please tell me what the code does from a problem solving perspective.
If I can't understand your code, then your code is legacy to me unfortunately. Tell me the problem and mental model the code is implementing and I can rewrite it or avoid rewriting it because I have your implementation, I understand it and I don't need to rewrite it.
There are very few people who regularly write as an exercise in thinking, though. But there are very few who would not benefit from it.
At the risk of being rude, what you're saying from some perspectives may read like "exercise this...", "exercise that..." and how no one dares to speak out against physical exercise. Well... that may be because it's mostly universally good for people (with definite exceptions). Writing is like exercise for the mind. Are there other ways to achieve most things than exercising your body or your mind? Yeah, I would say so - there are many paths to success, knowledge, wisdom, balance, expertise, wealth, and so on. But is exercise of the mind bad or detrimental? Generally, no. And that's why few people speak out against it.
I'm not sure what real good a downvote can serve. I will make an appeal to your understanding of human history.
Writing is a representation of language, and as such is the greatest, clearest manifestation of generalised human intellectual capacity. Writing as a technical achievement is the foundation of human civilisation.
> moreover in HN. The people around me, mostly don't care about writing other than code.
The best coders are coding for others to understand. In the great tradition of human writing, coding is communication.
> "Write as a form a wasting time"
> "Writing as a form of deluding oneself in being productive"
Hmm.
> writing is overrated
Take this kindly - you're doing it wrong. Which is fine; not everyone is a wordy thinker. That doesn't mean it's overrated.
The entirety of my experience with writing things down is that it is only ever helpful and useful in the understanding of a problem or the exploration of an idea.
I don't often look back at what I wrote. Partly that's because the process of writing helps me to remember something, and also the writing is the journey required to tech the destination, and once at the destination, the journey is no longer needed.
And yes, if there is an "other side" of the writing argument, I'm not in it, so I appreciate these posts, and generally nod in agreement. I also appreciate them as a reminder to both write more and more often.
https://newlearningonline.com/literacies/chapter-1/socrates-...
I recently learned writing is two things, what you know and how to market yourself. While I'd say a good amount is more of the former, HN highlights some of the absolute best pieces of the prior.
People should write. And those that touch a nerve probably did it well enough do receive critical feedback.
I would love to find a replacement to natural language writing for organizing and developing thoughts, one that was more structured and could be manipulated systematically. A programming language for thinking I guess.
I don't disagree with your ideas that it can be counter-productive. However, I'm not convinced that would be the majority perspective. I think the reason why it's not spoken about much is because there's no enforcing others to become writers. It's an individual choice and usually only affects yourself.
I think your central issue isn’t with writing in of itself, as the surplus of extraneous pointless vacuous writing that is out these days. Social media posts, tweets, content farming blogs, fake-FAQs, carousel listicles, comments comments comments- are surrounded by so much bad, pre-AI analog AI generated writing or quick takes written without deep thought. That’s what you probably have issues with, not with writing itself.