3 ms·

Thanks for the insight! Regarding documentation covering an overarching vision for the code: It is my experience that the person best-suited to write these doc

• angersock 11y ago
  Yep. The thing is, the company needs to understand that the smartest thing to do is to leave that person alone and task them on educating (here via docs, but also in other ways) the other developers (assuming the team is of sufficient size, which in my experience is the case as soon as total headcount is 3). Hoarding expertise like that is a good way to waste company resources (because other devs function at a great disadvantage) and to bring down stress upon onself (becuase you become a bottleneck and that gets to be super stressful). The fact of the matter is that it is anti-social and bad practice for these devs not to take a step back and write down the coherent vision of their product--and if they can't explain the vision in a handful of pages with some simple diagrams, they've probably deeply fucked up the design. The company, management usually, needs to bite the bullet and sacrifice short-term firefighting ability for mid-to-long-term training. If they won't do this, you should leave.
  • brwr 11y ago
    What you described is what I'm hoping to see over the next few months. I joined the company recently, so there's still a lot of internals that I don't fully understand.