News for hackers. Stuff that matters.
Re:Ask HN: Advice for a new and inexperienced tech lead? by sub7 on Thursday February 06, 2020 @11:49AM (#22257621)
Respectfully disagree on the "write it out first" advice. I'd argue "think it out first" or "talk it out first" is sufficient.

I found while scaling my team tended to bury themselves in miles of docs that really did not serve the customer or the company. A janky kind of working prototype of a solution is worth a ton more than a well thought out doc.

Re:Ask HN: Advice for a new and inexperienced tech lead? by fest on Thursday February 06, 2020 @04:18PM (#22260430)
Consider that a successful product will be maintained for years. It is highly likely that a people will come and go. Documenting already running code will inherently have less priority (both in the eyes of upper management an developers- the temptation to jump on the next project is huge). So if you don't start documenting first- odds are you never will.
Re:Ask HN: Advice for a new and inexperienced tech lead? by dharmab on Thursday February 06, 2020 @08:08PM (#22262253)
My team has a rule- if it's not in writing at a permalink it doesn't exist.

A simple 2-3 line github issue is often enough. what and why.

Re:Ask HN: Advice for a new and inexperienced tech lead? by jugg1es on Thursday February 06, 2020 @08:32PM (#22262395)
I disagree with this. Writing a set of "technical objectives" that say how a thing will work takes an hour at most and it helps you think through it better than a conversation. It also helps you pass information to QA. If someone asks what the thing does, you can just send them the link. Ultimately, taking an hour to write it down pays dividends later on.
Re:Ask HN: Advice for a new and inexperienced tech lead? by navyad on Friday February 07, 2020 @02:12AM (#22263854)
I would like to disagree here. Got into a team which has working prototype but not a single word on document. Which makes this hard to follow up with prototype.

Being tech lead in current position, I am stressing "document-first" approch it is either for client or tech team.

Re:Ask HN: Advice for a new and inexperienced tech lead? by cyode on Thursday February 06, 2020 @02:34PM (#22259457)
If you have remote teammates or may have any in the future (i.e. if your company allows remote engineers), a culture of writing things down is imperative.