Udemy
    •  
    •  
    •  
    •  
    •  
    •  
    •  
    •  
Turn what you know into an opportunity and reach millions around the world.
Learn More
Your cart is empty.
Keep shopping
Technical Writing: How to Write API Software Documentation
Rating: 4.4 out of 5(1,628 ratings)
15,634 students

Technical Writing: How to Write API Software Documentation

A framework for writing software documentation for an API as a technical writer, using Postman or Swagger UI
Created byJordan Stanchev
Last updated 1/2023
English

What you'll learn

  • What is API?
  • What is API documentation?
  • Which steps to follow to create API documentation?
  • How to use Swagger UI to write API documentation?
  • How to use Postman to check the functionality provided with an API
  • How to put your API documentation together in a GitHub wiki page!

Course content

4 sections53 lectures2h 49m total length
  • Introduction1:48
  • Slides Used in This Section0:03
  • What will you learn?2:38
  • What is an API?2:57
  • Benefits from using an API3:11
  • How does an API work?3:14
  • Who creates API and API documentation?4:00
  • What is an API documentation?4:51
  • Types of APIs1:34
  • Who reads API documentation?2:49
  • API documentation - examples17:47
  • API documentation framework0:32
  • API documentation - structure1:04
  • Step 10:22
  • Step 21:10
  • Step 30:31
  • Testing an API call3:02

Requirements

  • No programming knowledge is required

Description

Are you a technical writer who must write API software documentation? Do you wonder what you need to prepare and deliver to have high-quality API documentation and do not know where to start?

If yes, then this course is for you!


For Technical Writers, by Technical Writers: Navigate the world of API software documentation effortlessly with our hands-on course designed for aspiring technical writers.

Global Impact: Trusted by universities across Europe and top software companies for onboarding new technical writers. Join a community shaping the future of technical writing.

Simplified Learning: Technical writing made easy! No programming jargon—just straightforward explanations to help you understand API and API documentation.

Practical Steps: Unlock our unique framework, guiding you through the process of preparing and delivering high-quality API documentation. From concept to creation, we've got you covered.

Tools of the Trade: Master Swagger UI for automatic documentation generation and learn Postman to validate API functionality. Bring it all together on a GitHub wiki page with confidence.


Important Notice for Students in India:
In this course, we frequently use Stripe's API as an example. However, please note that Stripe services are invite-only in India. Due to this limitation, students located in India may not be able to fully experiment with the course examples involving Stripe and may be limited to observing the instructor's demonstrations.

Please consider this restriction before enrolling in the course.


Transform into a proficient API documentation writer:

  • Acquire practical skills for your writer's portfolio.

  • Impress managers and collaborate seamlessly with developers.

  • Elevate your technical writing career.

API stands for Application Programming Interface. An interface is a software abstraction, which allows two software applications to communicate with each other seamlessly.

There are two roles you need to consider when you write documentation about an API:

  1. The role of the developer who created the API. This developer needs to provide information about the way the API is supposed to work; what requests can it receive and what responses does is provide.

  2. The role of the developer who uses the API. This developer needs to read through the API documentation to understand the ways to connect to the API, the requests that he or she can send to the API, and the responses that the API shall return for these requests.

In this course, you will learn:

  • What is API and API documentation - explained in a way so that you can understand. No special programming knowledge is required! 

  • The steps you need to follow to prepare and provide documentation about your API - our unique framework to make sure you have steps to follow while preparing the API documentation.

  • How to use Swagger UI to write and generate API documentation automatically.

  • How to use Postman to check the functionality provided with an API, and

  • How to put it all together on a GitHub wiki page!

Transform into a proficient API documentation writer with our course!

Acquire hands-on skills to craft compelling API documentation, a valuable addition to your writer's portfolio.

Impress not only your manager but also developers with your newfound ability to confidently create documentation for diverse software development projects.

Elevate your technical writing career by enrolling today! Try it now, and see how easy it is to write API documentation, once you know which are the basic steps to follow!

Who this course is for:

  • Technical Writers
  • Information Developers
  • Software Developers
  • UX Writers