Technical Writing: How to Write API Software Documentation
What you'll learn
- What is API?
- What is API documentation?
- Which steps to follow to create API documentation?
- Which tools to use with an API
Course content
- Preview02:27
- Preview03:39
- Preview00:48
- Preview03:43
- 04:40Who Creates API and API Documentation
Requirements
- No programming knowledge is required
Description
Are you a technical writer who needs to 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!
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:
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.
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!
Which are the steps you need to follow to prepare and provide documentation about your API - a small framework to make sure you have steps to follow while preparing the API documentation.
Hints about 2 popular tools you can use to test an API and generate API documentation automatically. In the interest of saving you time, we shall just provide an overview of tools, such as Postman and Swagger, but we are not going into details about using these tools - they are already well documented and there are many courses about using these tools.
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
Instructor
![JPDocu School of Technical Writing](data:image/svg+xml,%3Csvg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64"%3E%3C/svg%3E){kind=avatar}
- 4.3 Instructor Rating
- 1,314 Reviews
- 28,639 Students
- 14 Courses
Learning technical writing is easy - after all, it's just plain docu!
JPDocu School of Technical Writing is a training company that is passionate about user assistance, technical communications, and making it a positive user experience. Our e-learning courses help us shape the next generation of technical writers and information developers, by providing them with simple to follow and practical, hands-on experiences with technical writing.
Our mission
Nowadays everyone talks about the professions of the future. People are scared that they are not prepared for the needs of the future of work. We believe that change is not to be feared. We believe that with the proper training, education, and practical experience, our customers will be ready to meet the future with joy. The best way to concur with this fear is by studying and learning.
JPDocu School of Technical Writing transforms this fear into practical knowledge, getting people ready for the job of the future - Technical Writing. Taking our programs online allows us to reach all of you across the globe!
Our Vision
JPDocu School of Technical Writing is here to deliver top-quality e-learning courses and training (both online and on-site) that help you learn the profession of the future. We bring our courses to the world using various training platforms and interactions with our students.