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
@DodaGarcia3 жыл бұрын
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!
@ErnestoCode4 жыл бұрын
Great speaker, loved the clean layouts of her slides, the simplicity is so elegant.
@lucemanb87323 жыл бұрын
she writes good documentation, couldnt expect less
@kresnofatihimani50732 жыл бұрын
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
@ColbyCBoone7 ай бұрын
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.
@zenginellc4 ай бұрын
This definitely helped in reflecting on my documentation styles and how to improve it. Thank you!
@n1gr0824 жыл бұрын
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
@roland75996 ай бұрын
Straight to the point and simply explained ❤
@hamedahmadi9291 Жыл бұрын
great content and beautiful smile at the end
@SamOween2 жыл бұрын
Thank you, I will use your technique to document my feature
@taraspelenio82594 жыл бұрын
Very good and structured description of base rules for creator of useful documentation
@nivasanbabusrinivasan10864 жыл бұрын
Beautifully explained, I loved the point about friendly documentation!
@bob-the-constructors991211 ай бұрын
Brilliant, thank you!
@Nicy123-45a Жыл бұрын
English is on different level mam
@MainlyWebStuff3 жыл бұрын
Nice talk - good advice, especially 'write readably'
@cthuloox4763 жыл бұрын
@Beth Aitman This was a great video on this subject. I learned a lot. Thanks!
@mosesket3 ай бұрын
Does anyone have a sample doc like she explained here
@preciousonyewuchi51282 жыл бұрын
Does anyone know how to get a link to the blog she mentioned?
@raoulkoopman94084 жыл бұрын
Anyone able to get the name of that blog?
@TheLegendSpeaker3 жыл бұрын
Great concise talk!
@Amy-zz5ln2 жыл бұрын
Can you please help me know how to get Software documentation writer job as a fresher?
@TheNickzer Жыл бұрын
Some great ideas.
@milo-hc9nk2 жыл бұрын
Fabulous video
@goktugerol11272 жыл бұрын
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_ Жыл бұрын
Only great or huge enterprises hire technical documentation specialists.
@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.