Document structured data and grow your skills in web API documentation. This course shows how to write and document using JSON and XML.
- APIs are revolutionizing the modern Internet. As the complexities of APIs increase, software companies need skilled technical writers who can document them. I'm Peter Gruenbaum, president of SDK Bridge, a company that specializes in API documentation. For eight years I was a commercial software developer, but in 2003 I combined my love of writing and technology to become a technical writer. This course will cover documenting structured data, which is the foundation of web API documentation.
I'll start by talking about how structured data works, and then I'll dive into the format called JSON, showing you both how to create JSON and how to document it. Then I'll do the same for the format called XML. Finally, I'll show you some of the tools that you can use to create high quality documentation. I'm excited to dive into the process of documenting APIs with you, so let's get started.
- The purpose of documentation
- Data types
- Structured data
- Writing JSON and XML
- Documenting one-level JSON responses
- Documenting nested JSON responses
- XML attributes and examples
- Documenting XML
- Structuring data documentation
Skill Level Intermediate
Project Management: Iterative Methodswith Bob McGannon1h 16m Appropriate for all
Technical Writing: Reportswith Judy Steiner-Williams2h 30m Appropriate for all
Introduction to JSON and XML Documentation
Next steps1m 10s
- Mark as unwatched
- Mark all as unwatched
Are you sure you want to mark all the videos in this course as unwatched?
This will not affect your course history, your reports, or your certificates of completion for this course.Cancel
Take notes with your new membership!
Type in the entry box, then click Enter to save your note.
1:30Press on any video thumbnail to jump immediately to the timecode shown.
Notes are saved with you account but can also be exported as plain text, MS Word, PDF, Google Doc, or Evernote.