Writing effective documentation | Beth Aitman |

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

LeadDev

LeadDev

Күн бұрын

Пікірлер
@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
@ColbyCBoone
@ColbyCBoone 8 ай бұрын
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 5 ай бұрын
This definitely helped in reflecting on my documentation styles and how to improve it. Thank you!
@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
@roland7599
@roland7599 7 ай бұрын
Straight to the point and simply explained ❤
@hamedahmadi9291
@hamedahmadi9291 Жыл бұрын
great content and beautiful smile at the end
@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
@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 Жыл бұрын
Brilliant, thank you!
@SamOween
@SamOween 2 жыл бұрын
Thank you, I will use your technique to document my feature
@cthuloox476
@cthuloox476 3 жыл бұрын
@Beth Aitman This was a great video on this subject. I learned a lot. Thanks!
@TheLegendSpeaker
@TheLegendSpeaker 4 жыл бұрын
Great concise talk!
@mosesket
@mosesket 4 ай бұрын
Does anyone have a sample doc like she explained here
@MainlyWebStuff
@MainlyWebStuff 3 жыл бұрын
Nice talk - good advice, especially 'write readably'
@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?
@TheNickzer
@TheNickzer 2 жыл бұрын
Some great ideas.
@Nicy123-45a
@Nicy123-45a 2 жыл бұрын
English is on different level mam
@Amy-zz5ln
@Amy-zz5ln 2 жыл бұрын
Can you please help me know how to get Software documentation writer job as a fresher?
@stronglonggg
@stronglonggg 4 жыл бұрын
Thanks! That was really effective 👍
@milo-hc9nk
@milo-hc9nk 2 жыл бұрын
Fabulous video
@Virus00000000000001
@Virus00000000000001 4 жыл бұрын
this was really good
@wattywhee2283
@wattywhee2283 2 жыл бұрын
Nice content, thanks.
@tiagosilveira3334
@tiagosilveira3334 2 жыл бұрын
Thank you!!!
@smllmp
@smllmp 3 жыл бұрын
Nailed it!
@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.
@jgtb0pl
@jgtb0pl 2 жыл бұрын
very informative
@wilhelmpaulm
@wilhelmpaulm 4 жыл бұрын
loved this ❤️
@giancarloprado8206
@giancarloprado8206 4 жыл бұрын
My english teacher send me here.
@manaralsahli9143
@manaralsahli9143 4 жыл бұрын
cool video thank ur teacher
@UeharaKeitaro上原恵太郎
@UeharaKeitaro上原恵太郎 5 ай бұрын
kinda hot
@EdwardSapp
@EdwardSapp 2 ай бұрын
Wonderful, thank you!
How to Document Your Code Like a Pro
19:03
ArjanCodes
Рет қаралды 103 М.
Writing great documentation
30:38
Igor Starikov
Рет қаралды 38 М.
Quilt Challenge, No Skills, Just Luck#Funnyfamily #Partygames #Funny
00:32
Family Games Media
Рет қаралды 55 МЛН
“Don’t stop the chances.”
00:44
ISSEI / いっせい
Рет қаралды 62 МЛН
Don’t Choose The Wrong Box 😱
00:41
Topper Guild
Рет қаралды 62 МЛН
СИНИЙ ИНЕЙ УЖЕ ВЫШЕЛ!❄️
01:01
DO$HIK
Рет қаралды 3,3 МЛН
How Senior Programmers ACTUALLY Write Code
13:37
Thriving Technologist
Рет қаралды 1,6 МЛН
How to Write a Novel in Google Docs
30:35
Abbie Emmons
Рет қаралды 468 М.
Software Planning and Technical Documentation
10:49
AltexSoft
Рет қаралды 164 М.
What nobody tells you about documentation
30:52
PyCon AU
Рет қаралды 92 М.
The 3 Laws of Writing Readable Code
5:28
Kantan Coding
Рет қаралды 778 М.
How I document my processes
7:36
MinorCo
Рет қаралды 26 М.
Quilt Challenge, No Skills, Just Luck#Funnyfamily #Partygames #Funny
00:32
Family Games Media
Рет қаралды 55 МЛН