Learn API Technical Writing: JSON and XML for Writers
4.5 (2,866 ratings)
Course Ratings are calculated from individual students’ ratings and a variety of other signals, like age of rating and reliability, to ensure that they reflect course quality fairly and accurately.
12,070 students enrolled

Learn API Technical Writing: JSON and XML for Writers

API Documentation1: Teaches technical writers how to document structured data. No programming experience required.
Bestseller
4.5 (2,866 ratings)
Course Ratings are calculated from individual students’ ratings and a variety of other signals, like age of rating and reliability, to ensure that they reflect course quality fairly and accurately.
12,070 students enrolled
Created by Peter Gruenbaum
Last updated 5/2020
English
English
Current price: $16.99 Original price: $24.99 Discount: 32% off
5 hours left at this price!
30-Day Money-Back Guarantee
This course includes
  • 1 hour on-demand video
  • 4 articles
  • 12 downloadable resources
  • Full lifetime access
  • Access on mobile and TV
  • Certificate of Completion
Training 5 or more people?

Get your team access to 4,000+ top Udemy courses anytime, anywhere.

Try Udemy for Business
What you'll learn
  • Read and understand structured data in JSON and XML formats.
  • Write documentation for JSON and XML files, for API documentation or other types of documentation.
  • Understand how to edit JSON and XML for tools that generate documentation.
Requirements
  • A text editor (such as Notepad or Atom) and a Word Processor (such as MS Word, Apple Pages, or Google docs)
Description

This is the first in a series of courses for technical writers who want to learn how to write API documentation. This course teaches how to document structured data, focusing on the two most popular structured data formats: JSON and XML. If you are new to API documentation, this is a great place to start. No programming experience is required, but technical writers with programming experience who want to know more about structured data will still find it useful.

What are APIs?

APIs (Application Program Interfaces) define how software systems talk to each other, and API documentation is a rapidly growing field. There is a strong need for writers who can understand APIs and explain them so that software developers can understand how to use them. API writers get to be in on the cutting edge of technology in high-paying positions.

What is in This Course?

By the end of the course, you will understand what APIs are, why they are important, and how to read and document structured data. In this course you'll find:

  • Eight videos that:
    • Provide background information on APIs and structured data
    • Break down sample JSON and XML files to show you how they work
    • Show real-time, narrated writing of JSON and XML documentation
  • Four hands-on exercises to lead you through building and documenting JSON and XML files
  • Two text-based lectures about useful software tools
  • Five short quizzes to keep you on your toes
  • PowerPoint presentations as a resource for every video lecture

The course takes approximately 2.5 hours to complete, depending on how fast you are with the exercises.

Who this course is for:
  • Technical writers with experience writing end-user documentation and how want to learn how to write API documentation. No prior programming or structured data experience is required.
  • Technical writers with programming experience who want details on best practices for documenting structured data.
Course content
Expand all 16 lectures 01:23:13
+ Introduction
3 lectures 11:56

Covers:

  • Teacher's background and credentials
  • What are APIs?
  • Why is API documentation important?
  • JSON, XML, and how they compare
  • Class overview
Preview 06:29

Covers:

  • Data types
  • Boolean values
  • Structured data
Preview 04:44

Please answer the following questions about data types.

Identify Types of Data
3 questions

For this class, you'll be creating JSON and XML files. This lecture recommends some tools you can use.

Tools for Writing JSON and XML
00:43
+ JSON
5 lectures 25:11

Covers:

  • The history of JSON
  • Basic data types
  • Arrays
  • Objects
  • Nesting
  • Indentation

On completion, students will be able to read and understand JSON files.

Note that this for this (and all video lectures), the PowerPoint presentation is included as a resource.

What is JSON and How Does It Work?
08:01

This lecture is actually a hands-on exercise. Create a JSON file according to the given specifications.

Create a JSON File Exercise
3 pages

Please answer the following questions about JSON.

JSON Quiz
4 questions

Covers:

  • How JSON is used for both requests and responses
  • Documenting a JSON element
  • Documenting acceptable values
  • Documenting element nesting
Documenting JSON
16:52

This lecture is an exercise where you will document three JSON files.

JSON Documentation Exercise
3 pages

Answer these questions about JSON documentation:

JSON Documentation
3 questions

I suggested using indentation in tables to indicate nesting. More recently, I have seen a different approach using sample JSON. This short article describes this approach.

An Alternative to Indenting
00:18
+ XML
4 lectures 19:48

Covers:

  • What is XML?
  • Tags and content
  • Attributes
  • Namespaces and Comments
  • Indentation
  • Schemas

On completion, students will be able to read and understand XML files.


What is XML and How Does It Work?
10:59

This lecture is an exercise where you will create three XML files according to specifications.

Create XML Exercise
3 pages

Please answer the following questions about XML.

XML Quiz
2 questions

Covers:

  • Differences between XML documentation and JSON documentation
  • Documenting attributes
  • Using multiple tables

On completion, students will know the basics of how to document XML.

Documenting XML
08:49

  This lecture is an exercise where you will document two XML files.

XML Documentation Exercise
3 pages

Answer the following questions about XML documentation:

XML Documentation
3 questions
+ Final Words
4 lectures 14:16

Covers what kinds of tools are available for documenting JSON and XML.

Tools for Writing Structured Data Documentation
02:47

Covers:

  • Why use structured data for documentation
  • Using JSON to describe APIs
  • Using XML to describe XML (XSD)
  • Disadvantages to this approach
Using Structured Data for Documentation
06:01

Covers:

  • Review of everything you've learned in this course
  • What is the next step for learning to document APIs
Review and Next Steps
04:55

Learn how to document REST APIs.

Bonus Lecture: Offer for Next Course in the Series
00:33