Видео

Thanks for adding this to a playlist. Otherwise I was overwhelmed by website navigation

Thanks for your continuing commitment to provide resources in this unsung hero field.

I’m wrestling with this exact problem for a client - thanks for making

Loved it. ❤

Great learning material! Million Thanks to you for sharing your valuable knowledge to all the tech writers.

Thanks Tom, very pleasant listening, it helped with collating my thoughts on our own API Docs strategy 🙂. Interesting times.

Good one Tom!

Great talk. Speaking of innovation is this space, I hope you don't mind if I mention a docs-as-code tool I'm working on, OpenSquiggly. Just Google for it and it should come up with the first link. It's not a static site generator, but rather what I call a dynamic site generator that dynamically retrieves Markdown files from Git and assembles it on-the-fly into a documentation site. It can also be used by developers as a code note-taking and research tool. It supports both internally authored documents, like a wiki, as well as external authored documents, like docs-as-code. So it's a hybrid solution that addresses a lot of the challenges that you mentioned in your talk. Thanks.

Tom's podcasts, talks, and idratherbewriting site are a gift to the tech writer community.

I’ve recently finished reading Curbing Traffic the human case for fewer cars in our lives by the same authors. Have you read this one too?

11:20 OMG yes my city in New Zealand is so frustrating as we had the option to build out a system similar to OV feits but the instead went with Lime bikes and scooters! 😔

6:30 Yeah, so awesome that you considered it! Next step is to email you councillor and ask them to build more bike infrastructure for all ages and abilities 😊

One thing to note, (and I don’t have any concrete evidence on this) but when you say that most new bike sales are ebikes, I would point out that it’s similar to how most new cars sales are electric (in some countries) yet we still see plenty of ICE cars on the road, simply because there were so many before hand. This would be the same as bikes in the Netherlands, lots of people already have a normal pedal bicycle and they don’t just disappear. Another thing to consider is that many Dutch will have a beat up old bike they use to get to work or the train station that they leave on the street (because they don’t care if it does get stolen) and they will keep their expensive bikes inside or for trips where they won’t be leaving it outside all day or all night long. Those older bikes are what you predominantly see parked everywhere.

I personally believe we're in a AI bubble, I don't think it will ever replace humans. Nevertheless we still need humans to supervise AI work. This goes into a deep philosophical debate of whether AI/robots will ever replace us, i.e creative beings. I was looking for a technical writing podcast. Glad I've found you! Cheers from Indonesia.

Thanks for this video, this book is on my must read list as an avid motorcyclist and technical but intuitive minded person. I constantly struggle with these two modes of thought, which one is right or wrong or better or worse, and it’s such a gray area. I intuitively know that with any work I’ve ever produced, or anything of greatness I have ever achieved, there was more to it than technical knowledge and practice. There was some sort of intuition or flow, or feeling of connection, that’s completely unexplainable, and that these two things can coexist makes the whole concept of this book is so interesting.

The ideal podcast length for me is about 1.5 hours because I will want to listen on 2x speed and spend about 45 mins on a topic.

Good insights.

I used the severance money from my layoff to buy Microsoft stock as my personal UBI!

10:31 the funny thing is his writing style was purposefully made to be easier and less technical than traditional analytic philosophy

My favorite philosophical work and I graduated from UCLA with a degree in philosophy.

Great talk! I'll pushback a bit on citing AI tools: IMHO you should cite them, and Bard/ChatGPT will let you generate shareable URLs that show the exact conversation you had.

Glad I found you on RUclips!

Great list! Good to document concrete everyday use cases.

Promo-SM 🙌

Many talk about this in the abstract, but I really appreciated this deep-dive into the nitty gritty details. Thanks for sharing your experience!

Such a good chat. Thank you!

Hey Tom, just letting you know that I really appreciate this format. Kept me focused. Thanks!

Do you think that the only benefit is saving time? Or did Claude come up with certain ideas that actually enhanced the substance of the info?

Thank you!!

very well explained, I study this and already struggled with the various usual tools but starting to figure them out. Interested in software documentation, so good to know what I have to focus on. thankss

Archbee is not bad, but I’ve been trying out Theneo and I found the experience much better. Their latest editor, with the AI assistant, was super helpful for me and my team, and the published doc looks much neater

HELP

Does it mean that i can't have a final version of an Api before i've finished the development of the api it's self ?

This video is underated

SECURITY

SECURITY

it's very surprising how little these guys know about software. I'm going to make a video for them. 30 minutes in and I'm wondering why people get paid for this. The amount of work he's talking about is what I do by accident while getting real stuff fixed.

This presentation is so thorough and helpful. Thanks!

Hey tom, please i would love if you could do a video on how to start a portfolio as a technical writer. I'd appreciate your feedback

Minor correction: HTTP is an application protocol not a transport protocol.

Starts at 8:21

Hi...I'm from Louisiana so I'm not familiar with the area..My little brother was killed June 26,2020 In the Guadalupe River at Hedding and ruff drive..He was a science teacher and a cross-country track coach at evergreen Valley high school.. I'm just trying to see if anyone saw him around..if you need a photo please let me know.. Thank you

Great intro into API Documentation. Thank you.

Thanks 👍

Good learning for a beginner !

1) Suppose, I have a schema for Project model which contains 20 properties. Now for my project-dropdown API I only need 3 properties from the schema then how I can refer the schema and pick few properties only? 2) I have 2 schemas, one for Project with 20 properties and another one is Task with 10 properties. Now for ProjectDetails API I have response something like { id: 1, name: "ProjectName", tasks: [ {id: 1, name: "TaskName"} ] } Now how I can accomplish this nested object by referring both individual schema which are Project and Task 3) Can I have search box in Swagger UI to filter APIs?

The best intro i have seen.

Very interesting Tom

By product overview do you mean the whole web page given on websites in product section?? Or one particular section in guides that we write??