Writing effective documentation | Beth Aitman |

  Рет қаралды 110,074

LeadDev

LeadDev

Күн бұрын

Пікірлер: 38
@rushebshah
@rushebshah 3 жыл бұрын
1:05 start with what the reader needs 2:26 write less 4:05 write the outline first 5:19 rubber ducking 6:26 write readably 8:41 it's not just about documentation
@DodaGarcia
@DodaGarcia 3 жыл бұрын
This was so useful!! I have always ignored documentation (aside from inconsistent comments in the code) because I'm typically the only user, but I've recently realized that when you only use a piece of software every few months, you might as well be a total stranger to it because you have to relearn how all of it works each time. This inspired me to document the API so that I don't have that extra friction next time I have to use the code. Thank you Beth!
@ErnestoCode
@ErnestoCode 4 жыл бұрын
Great speaker, loved the clean layouts of her slides, the simplicity is so elegant.
@lucemanb8732
@lucemanb8732 3 жыл бұрын
she writes good documentation, couldnt expect less
@kresnofatihimani5073
@kresnofatihimani5073 2 жыл бұрын
swear to god, she's right. ive seen documentations with abundance in details but does not help much in achieving what i want which usually forces me to look immediately at a use case in a medium blog or something
@ColbyCBoone
@ColbyCBoone 7 ай бұрын
This was super helpful , I’m a platform PM & writing documents for a technical audience has been challenging I’m looking to grow an improve in this area.
@zenginellc
@zenginellc 4 ай бұрын
This definitely helped in reflecting on my documentation styles and how to improve it. Thank you!
@n1gr082
@n1gr082 4 жыл бұрын
Great talk! I love the last point. Often people try to mitigate the problem with documentation and don't try to solve the underlying problem
@roland7599
@roland7599 6 ай бұрын
Straight to the point and simply explained ❤
@hamedahmadi9291
@hamedahmadi9291 Жыл бұрын
great content and beautiful smile at the end
@SamOween
@SamOween 2 жыл бұрын
Thank you, I will use your technique to document my feature
@taraspelenio8259
@taraspelenio8259 4 жыл бұрын
Very good and structured description of base rules for creator of useful documentation
@nivasanbabusrinivasan1086
@nivasanbabusrinivasan1086 4 жыл бұрын
Beautifully explained, I loved the point about friendly documentation!
@bob-the-constructors9912
@bob-the-constructors9912 11 ай бұрын
Brilliant, thank you!
@Nicy123-45a
@Nicy123-45a Жыл бұрын
English is on different level mam
@MainlyWebStuff
@MainlyWebStuff 3 жыл бұрын
Nice talk - good advice, especially 'write readably'
@cthuloox476
@cthuloox476 3 жыл бұрын
@Beth Aitman This was a great video on this subject. I learned a lot. Thanks!
@mosesket
@mosesket 3 ай бұрын
Does anyone have a sample doc like she explained here
@preciousonyewuchi5128
@preciousonyewuchi5128 2 жыл бұрын
Does anyone know how to get a link to the blog she mentioned?
@raoulkoopman9408
@raoulkoopman9408 4 жыл бұрын
Anyone able to get the name of that blog?
@TheLegendSpeaker
@TheLegendSpeaker 3 жыл бұрын
Great concise talk!
@Amy-zz5ln
@Amy-zz5ln 2 жыл бұрын
Can you please help me know how to get Software documentation writer job as a fresher?
@TheNickzer
@TheNickzer Жыл бұрын
Some great ideas.
@milo-hc9nk
@milo-hc9nk 2 жыл бұрын
Fabulous video
@goktugerol1127
@goktugerol1127 2 жыл бұрын
Nice, but I prefer writing the documentation of the things I make myself with the other Sr. engineers. Never worked with a technical writer, maybe I see some significant difference if I try. Is there anyone think as same as me?
@techne_
@techne_ Жыл бұрын
Only great or huge enterprises hire technical documentation specialists.
@goktugerol1127
@goktugerol1127 Жыл бұрын
@@techne_ but isn't it doing a double job someone who doesn't make the app writing a documentation and they need to review the code line by line so they can understand and write the docs.
@wattywhee2283
@wattywhee2283 2 жыл бұрын
Nice content, thanks.
@stronglonggg
@stronglonggg 4 жыл бұрын
Thanks! That was really effective 👍
@tiagosilveira3334
@tiagosilveira3334 2 жыл бұрын
Thank you!!!
@jgtb0pl
@jgtb0pl 2 жыл бұрын
very informative
@Virus00000000000001
@Virus00000000000001 4 жыл бұрын
this was really good
@smllmp
@smllmp 3 жыл бұрын
Nailed it!
@wilhelmpaulm
@wilhelmpaulm 4 жыл бұрын
loved this ❤️
@giancarloprado8206
@giancarloprado8206 4 жыл бұрын
My english teacher send me here.
@manaralsahli9143
@manaralsahli9143 4 жыл бұрын
cool video thank ur teacher
@harem_lord-FFM
@harem_lord-FFM 4 ай бұрын
kinda hot
@EdwardSapp
@EdwardSapp Ай бұрын
Wonderful, thank you!
Software Planning and Technical Documentation
10:49
AltexSoft
Рет қаралды 159 М.
бабл ти гель для душа // Eva mash
01:00
EVA mash
Рет қаралды 9 МЛН
The 3 Laws of Writing Readable Code
5:28
Kantan Coding
Рет қаралды 712 М.
146. How Do I Document My Code?
20:17
IAmTimCorey
Рет қаралды 22 М.
Don't Use ChatGPT Until You Watch This Video
13:40
Leila Gharani
Рет қаралды 1,7 МЛН
How to Write a Paper in a Weekend (By Prof. Pete Carr)
11:39
Surviving and Thriving in Higher Education
Рет қаралды 2,3 МЛН
How Senior Programmers ACTUALLY Write Code
13:37
Thriving Technologist
Рет қаралды 1,6 МЛН
Software tools for creating awesome engineering documentation
13:09
How to Document Your Code Like a Pro
19:03
ArjanCodes
Рет қаралды 99 М.
How to: Work at Google - Example Coding/Engineering Interview
24:02
Life at Google
Рет қаралды 7 МЛН
How to Write a Novel in Google Docs
30:35
Abbie Emmons
Рет қаралды 459 М.
How I document my processes
7:36
MinorCo
Рет қаралды 24 М.