News for hackers. Stuff that matters.
Re:We fired our top talent. Best decision we ever made by threatofrain on Saturday October 14, 2017 @10:04PM (#15475474)
I also think it's kind of silly to criticize a solo developer for not documenting. Has anyone seen a mid-sized team that doesn't explicitly delegate or make documentation a priority?

Now you expect a solo person to document?

Re:We fired our top talent. Best decision we ever made by zzalpha on Saturday October 14, 2017 @11:57PM (#15475815)
No developer is a solo developer. At a bare minimum, Present You is working with Future You. And Future You would appreciate it if Present You documented your work.
Re:We fired our top talent. Best decision we ever made by seanmcdirmid on Sunday October 15, 2017 @12:25AM (#15475883)
The biggest problem of being a solo developer is that there is no one else to drive documentation needs. Yes, documentation would be great for future you, but present you has no one (including future you) to chat with about the code to get an idea of what documentation would be useful. If you are forced to work just inside your head, then the result is going to be obvious and predictable.

And no, talking to the rubber ducky doesn't help.

Re:We fired our top talent. Best decision we ever made by RangerScience on Monday October 16, 2017 @07:08PM (#15487394)
I use "tired me". I think once or twice I've used "inebriated me".

In the beginning of my career I was much more diligent about this (but I also didn't write as readable code, so it was more necessary); the exercise was simple:

When I hit the stupid part of the day (the end of the day), I go back over code. When I don't understand something, I write down something about my confusion. In the morning, when I'm back to being smart, I convert all the confusion to comments and/or better code.

Re:We fired our top talent. Best decision we ever made by mannykannot on Sunday October 15, 2017 @09:40AM (#15477057)
on the contrary, many good developers do know what to write. They understand what the software does, and why, and they are capable of explaining it. They know what decisions were made, and why they were chosen over other options. Above all, they know where the tricky bits are (because they solved them), which are, for the most part, going to be the tricky bits for anyone following.

Anything you talk to the rubber ducky about probably deserves writing down.

Re:We fired our top talent. Best decision we ever made by mannykannot on Sunday October 15, 2017 @09:31AM (#15477026)
> Now you expect a solo person to document?

Yes, unless it is single-use code. Otherwise, if the person is only developing for himself, he can choose whether or not to write any documentation, but if he is sensible, he will write something.

It is moot anyway, as he was not supposed to be a solo developer.

Re:We fired our top talent. Best decision we ever made by valuearb on Saturday October 14, 2017 @11:43PM (#15475769)
I expect every professional developer to do at least the minimum necessary level of documenting, be they solo, small team, big team, startup, corporate, etc, etc.