How to write a great documentation (in 5 points) 1. Use question and answer look (more like FAQs) 2. Use pointers wherever possible a. maximum 5, preferably 3 b. if goes beyond 5, try making sub-points instead 3. Diagrams wherever possible. a 🖼 is worth a 1000 words 4. Be precise, but accurate. And have w h i t e s p a c e s , increases readability. 5. Avoid similar synonyms, generous adjectives, spellnig and grammatical the mistakes a. repeat same words already used to refer something b. have links to go to something previously explained c. Avoid external links, instead provide a brief. Add link only for confidence (reduces distraction) Add if you know something that I am missing
Neetcode, you helped me get a job a year ago and now you're helping me get promoted with this video. I think another channel or other videos on how to get promoted would be so awesome! Thank you as always neetcode
Although I’m late to this, it is interesting to see this video. My current degree required a “professional writing” course which discussed how to effectively write technical information in a means that is visually readable (layout of page) and concise/to the point. The other interesting topic was “plain English” in how it breaks things down to be accessible to all audiences no matter their technical knowledge. It’s fascinating to see the one “English” class Ive enjoyed in college be applicable
I have been following your channel for a long time, since covid. After watching your dropping out of Amazon video, you became my inspiration. I hope I get to write my story as yours. Thankyou for your content.
You never attended my swe onboarding class 😀. I had a slide dedicated to “you better learn to write real fast AND carve out lots of time to read” and I would pause, elaborate, AND show 3 different design document examples.
Such a great video if anyone wants to improve his/her career in Software Industry. Very few people tell this. Generally I learned it through experience.
I always prefer to get honest feedback than being always pat on the shoulder especially when one has impostor syndrome because with an honest feedback we can smooth rough corners.
Writing a design doc probably takes like half the time that writing code to do the design does on average. Some people are good at it, but for some programmers writing docs is pure torture.
Then there's the question - do I need to keep the design doc up to date when everything changes after the first iteration? Nobody is reading it anymore, seems like a waste of time.
Serves as a project road map. Provides an anchor for controlling scope. Is an onboarding tool for new team members. Helps you think through the design and test some of your assumptions. Leaves a record of not only what was done but why it was done for future maintenance teams.
Because you have been successful enough so that by criticizing you can bring attentions. As for that guy claim himself as a techlead, please ignore that clown
This is a critical and great video for people to watch to improve themselves, not even necessarily coding related
How to write a great documentation (in 5 points)
1. Use question and answer look (more like FAQs)
2. Use pointers wherever possible
a. maximum 5, preferably 3
b. if goes beyond 5, try making sub-points instead
3. Diagrams wherever possible. a 🖼 is worth a 1000 words
4. Be precise, but accurate. And have w h i t e s p a c e s , increases readability.
5. Avoid similar synonyms, generous adjectives, spellnig and grammatical the mistakes
a. repeat same words already used to refer something
b. have links to go to something previously explained
c. Avoid external links, instead provide a brief. Add link only for confidence (reduces distraction)
Add if you know something that I am missing
and a thing everyone forgets: write what the thing even is. This part is missing in pretty much all design docs.
Neetcode, you helped me get a job a year ago and now you're helping me get promoted with this video. I think another channel or other videos on how to get promoted would be so awesome!
Thank you as always neetcode
Man, you are so good, 100% agree each word. Especially about the speakers that go straight in-depths since 0th min on their presentation
I remember during college, I didn't even know what to write in my documentation/report but it was like a competition to write a book back then 😂
This type of content is really interesting to watch 😁
My product manager roasts me for not being able to finish up date pickers in a day. "You're taking too much time" - my product manager.
1:46 one could say he was lubing it up before he went in.
I love your passionate eloquence ❤🔥
20 pages is long? Don’t work for the government, that’s just the intro.
what an amazing video ! thank you it was helpful
Although I’m late to this, it is interesting to see this video. My current degree required a “professional writing” course which discussed how to effectively write technical information in a means that is visually readable (layout of page) and concise/to the point. The other interesting topic was “plain English” in how it breaks things down to be accessible to all audiences no matter their technical knowledge. It’s fascinating to see the one “English” class Ive enjoyed in college be applicable
Navdeep learnt how to clickbait people. haha that thumbnail got me. But glad I clicked tho. good content
was he his tech lead?
@@dao-lamhe said his tech lead was smart, make of that what you want 😂
You don't get negative comments because your videos are perfect 😉
This is pretty good tip! Thanks for sharing this!
Ah crap. I didn’t like writing design docs in Amazon, so I was hoping to go to Google. Turns out they write even more docs /:
I have been following your channel for a long time, since covid. After watching your dropping out of Amazon video, you became my inspiration. I hope I get to write my story as yours. Thankyou for your content.
You never attended my swe onboarding class 😀. I had a slide dedicated to “you better learn to write real fast AND carve out lots of time to read” and I would pause, elaborate, AND show 3 different design document examples.
Thank you. You are the best
1. Amazing examples and insight. 2. But was your tech lead the actual Tech Lead??
Such a great video if anyone wants to improve his/her career in Software Industry. Very few people tell this. Generally I learned it through experience.
Apart from career wise, it just makes the industry so much better if people do this more
Great vid
Take this as a medallic symbol of hope, indeed.
The crossover we didn't know we needed
Unfortunate clickbait preview
Yup
But was that THE tech lead?
I would love to see a before and after after design doc video
7:00 You need to indent your lists, it's easier to read.
How many more clips do u have 😂😂😂😂
Yes.
for a sec i thought techlead roasted you
I always prefer to get honest feedback than being always pat on the shoulder especially when one has impostor syndrome because with an honest feedback we can smooth rough corners.
Writing a design doc probably takes like half the time that writing code to do the design does on average. Some people are good at it, but for some programmers writing docs is pure torture.
ChatGPT writes my design docs
No way TechLead(at google and facebook) is so wholesome!
What a great video
Then there's the question - do I need to keep the design doc up to date when everything changes after the first iteration? Nobody is reading it anymore, seems like a waste of time.
Now I know why Google API documentation is so crappy. Googler's don't step on each others toes.
Plug it, we here for that ....
Keep doing more of these videos
hey, any thoughts on making a competitive programming question series? that would be really helpful.
basically KISS
i never had to write a design doc in 20 years. i think they are useless unless you have *many* readers and the design won't change next week.
dude didn't you have chatgpt back then?
Good info
What is the point of a design doc if no one will really read it?
Serves as a project road map. Provides an anchor for controlling scope. Is an onboarding tool for new team members. Helps you think through the design and test some of your assumptions. Leaves a record of not only what was done but why it was done for future maintenance teams.
Why is this other guy there on the thumbnail?
Because you have been successful enough so that by criticizing you can bring attentions. As for that guy claim himself as a techlead, please ignore that clown
Very helpful 👌🏻👌🏻
Where are all these clips from, it looks from live streams but I cant find those live streams in your youtube
You're looking on the wrong channel
smart guy.
Me a director at big tech got appreciated for 50 page design doc.
Could you bring Konrad back to roast this design on cam?
@Neetcode
Please share your equipment. I like your voice a lot.
Maybe because of your mic.😁
I clicked this thinking it is real design problems and solution criticism. 😅.
This design doc you showed doesn't do anything.
It just lists a bunch of services other people wrote.
Programming is not about this.
Was he the tech lead in your group for real ?
I’m from Florida. I know what a pub sub is
Use bard to clean it up
so why not make videos about how to write good design documents ? I would like to pay for that😂🎉🎉
AWS be like: 😬
I'm looking for a tech lead - a super interesting Fintech opportunity.
kinda got baited by the thumbnail...
Anyone else thinks he is talking faster than usual?
noice
Geeks, bruv
easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy easy homie
fn' git gud then