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
Hi Tom. Great intro. I've been taking a few bootcamp courses and here is what I find frustrating in those and in this course (and in API docs in general). You have us use the By city name endpoint for the open weather API which (it would seem) queries cit name or city name and country code. And yet, in Postman, you then enter zip, units (somehow knowing to use imperial), and appid. How do you know to enter this? I looked all through the docs and see nowhere that this info is specified yet, somehow, you knew to enter this specifically. For those of us that are new to this, how would we find this information?
I think I am simply implementing some of the required parameters specified in the doc, though I might not have explained where in the doc those parameters are specified. The OpenWeatherMap docs aren't the greatest example -- the API just seemed like a stable one.
@@tomjoht Thanks a lot for your valuable response Sir!!, Need a help from you could you suggest directly jumping to AIP documentation would be okey or I need to find the entrance door? Little confuse as waisted 3-4 years in doing various things. I have heard and read a lot about you and your unique website especially website name. Or you have video or pdf guide for starters please share, It will be helpful for me and your fans 👣.
Tom's podcasts, talks, and idratherbewriting site are a gift to the tech writer community.
Great learning material! Million Thanks to you for sharing your valuable knowledge to all the tech writers.
Absolutely brilliant top-level overview of what's required in good API documentation. Thanks for uploading.
This is what i was looking for, clear and crisp info about API documentation. Thanks
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
Great intro into API Documentation. Thank you.
The best intro i have seen.
Great learning material! Thanks for your work Tom.
This is an awesome lecture. Thanks for uploading.
Minor correction: HTTP is an application protocol not a transport protocol.
He said, transfer protocol not transport. 🙂
Ah, my bad. Thanks
This video is underated
Hi Tom. Great intro. I've been taking a few bootcamp courses and here is what I find frustrating in those and in this course (and in API docs in general). You have us use the By city name endpoint for the open weather API which (it would seem) queries cit name or city name and country code. And yet, in Postman, you then enter zip, units (somehow knowing to use imperial), and appid. How do you know to enter this? I looked all through the docs and see nowhere that this info is specified yet, somehow, you knew to enter this specifically. For those of us that are new to this, how would we find this information?
I think I am simply implementing some of the required parameters specified in the doc, though I might not have explained where in the doc those parameters are specified. The OpenWeatherMap docs aren't the greatest example -- the API just seemed like a stable one.
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 ?
Thanks 👍
I am your 600th sub x'D
What is STC?
Society for Technical Communications
Hi, is it possible to start tech writing carrier with API documentation?
sure, if you have strong tech skills and know how to write, and can prove it with a portfolio, you can surely get your foot in the door somewhere.
@@tomjoht Thanks a lot for your valuable response Sir!!,
Need a help from you could you suggest directly jumping to AIP documentation would be okey or I need to find the entrance door? Little confuse as waisted 3-4 years in doing various things. I have heard and read a lot about you and your unique website especially website name. Or you have video or pdf guide for starters please share, It will be helpful for me and your fans 👣.