Hacker News Reader

The single hardest thing in software development is brain-to-brain information transfer. It works really badly. But in software development (especially at larger scales), everything depends on it.

So work on writing technical information unambiguously. Not code, but written language. It's like a superpower in software development.

View on HN

@AnimalMuppet, one of the classes I enjoyed most was technical writing, which we'll be continuing in the second semester. I agree that expressing ideas clearly and unambiguously is important -- I'll continue working on this. Thank you for sharing your input!

@aireo, one often heard advise to hone those technical writing skills is to start a technical blog where you document what you have learned/investigated. If you use GitHub pages (free) to host the blog, you’ll learn some git and static site generation based on markdown as well.

Viewing this blog as your own “external memory” or a place where you document your journey can help to overcome some of the factors that may be blocking when aiming to write for a general (developer) audience.

I love this idea. I also see the value in reflecting upon what's been learned. Appreciate this great input.

Reply on news.ycombinator.com