News for hackers. Stuff that matters.
Re:Drunk Post: Things I've Learned as a Sr Engineer by elliotec on Sunday May 30, 2021 @03:27PM (#27335895)
Can you elaborate on that? Why journalism in particular? Have you done this? Are you better at docs?
Re:Drunk Post: Things I've Learned as a Sr Engineer by dijit on Sunday May 30, 2021 @03:56PM (#27336169)
I studied journalism at college as part of a more general media studies course.

It does help but I am not sure I would describe _my_ education as a panacea.

The main reason it was good was because it helps frame how you think of writing,

The most important things go first. Statement of fact, then you go into what the implications are, then you start introducing less and less relevant elements.

when you’re writing you keep the 5 “W’s” in mind, make sure you answer them. (Who what where when why), for instructive documentation you add: How.

Obviously an education bakes this into you in a better way than I can convey here.

What I learned is probably only decent for writing overviews.

Personally I find structure to be the biggest bottleneck/difficulty when making documentation.

What do others normally struggle with that don’t have this education?