Edit me

Курс по документированию API. Вольный перевод курса Documenting APIs: a guide for technical writers, составленного Томом Джонсоном, техническим писателем Amazon.

Коротко о курсе

Тяжелых и скучных лекций об абстрактных понятиях здесь не будет.

Курс по написанию документации REST API подразумевает практический подход к документированию REST API. На этом курсе будем заниматься изучением документации API на примерах использования API сервисов прогноза погоды.

Разберем API на составные части, узнаем о конечных точках, параметрах, типах данных, аутентификации, curl, JSON, командной строке, консоли разработчика Chrome, JavaScript и прочих деталях, связанных с REST API.

Идея курса в следующем: посмотреть на реальные сценарии использования API, сделав этот курс эффективным. Изучать концепты API независимо от контекста мы не будем.

Во время прохождения курса:

  • изучим стандарты, инструменты и спецификации REST API;
  • узнаем о необходимых разделах в документации API;
  • проанализируем примеры документации REST API различных компаний;
  • узнаем, как присоединиться к опен-сорс проекту, для получения опыта;
  • и многое другое.

Начать обучение 👨‍💻

Модули курса

  1. О модуле “Введение в REST API”

  2. О модуле “Используем API как разработчики”

  3. О модуле “Документирование конечных точек”

  4. Спецификация OpenAPI и Swagger

  5. Тестирование документации

  6. Концептуальные разделы

  7. Публикация документации

  8. Работа технического писателя

  9. Нативные библиотеки API

  10. Глоссарий API и источники

  11. Документирование кода