دوره آموزشی یادگیری API Documentation با JSON و XML

دوره آموزشی یادگیری API Documentation با JSON و XML

1 ساعت 19 دقیقهمتوسط2017-01-30

مدرسین

Peter Gruenbaum

Peter Gruenbaum

Computer Programmer, Technical Writer

جزئیات دوره

تو این دوره یاد می‌گیری چطوری داده‌هایی که از طریق وب APIها ارسال و دریافت می‌شن رو به صورت دقیق و قابل فهم مستند کنی تا توسعه‌دهنده‌ها بتونن راحت‌تر برنامه‌هایی بسازن که بتونن از این داده‌ها درست استفاده کنن.
پیتر گرونبام، کارشناس برنامه‌نویسی و نویسندگی فنی، می‌دونه که APIها روزبه‌روز اهمیت بیشتری پیدا می‌کنن. به همین دلیل تو این آموزش، روش مستندسازی داده‌های ساختارمند رو با فرمت‌های رایج تبادل داده بهت یاد می‌ده تا مهارت‌های پایه و محکم تو مستند کردن APIها بدست بیاری.
پیتر مزایای مستندات خوب رو توضیح می‌ده، تفاوت درخواست‌ها (requests) و پاسخ‌ها (responses) رو برات روشن می‌کنه و یاد می‌گیری چطوری با انواع داده‌های متداول مثل عدد، متن، آرایه و دیکشنری کار کنی.
بعدش، یاد می‌گیری چطوری داده‌های ساختارمند رو با فرمت‌های محبوب JSON و XML ایجاد و مستندسازی کنی.
دوره رو با بررسی مزایا و معایب ابزارهای مختلف مستندسازی و همکاری مثل ویکی‌ها و پایگاه‌های دانش تموم می‌کنه.

اهداف یادگیری دوره
✅ آشنایی با هدف مستندسازی API
✅ شناخت انواع داده‌های رایج
✅ کار با داده‌های ساختارمند
✅ نوشتن و مستندسازی JSON
✅ نوشتن و مستندسازی XML
✅ آشنایی با زبان Markdown
✅ مستندسازی پاسخ‌های JSON ساده و تو در تو
✅ مستندسازی ویژگی‌ها و نمونه‌های XML
✅ ساختاردهی مستندات داده‌ها

مهارت ها

XMLJSONAPIsFront-End Web DevelopmentLearningWeb DevelopmentProgramming LanguagesOpen SourceSoftware Development

سرفصل ها

مقدمه ای بر اسناد JSON و XML

  • خوش آمدید
  • آنچه باید بدانید
  • استفاده از فایل‌های تمرین
  • چرا JSON و XML را مستند کنید
  • انواع داده‌ها و داده‌های ساخت یافته
  • ابزارهایی برای نوشتن JSON و XML
  • علامت گذاری
  • چالش Markdown
  • راه حل نشانه گذاری

JSON

  • اصول اولیه JSON
  • نمونه‌های JSON
  • چالش JSON ایجاد کنید
  • راه حل JSON ایجاد کنید
  • مستندسازی پاسخ‌های JSON یک سطحی
  • مستندسازی پاسخ‌های JSON تو در تو
  • مستندسازی درخواست‌های JSON
  • مستندسازی چالش JSON
  • مستندسازی راه حل JSON

XML

  • مبانی XML
  • ویژگی‌ها و مثال‌های XML
  • XML پیشرفته
  • چالش XML
  • راه حل XML
  • مستندسازی XML
  • چالش مستندسازی XML
  • راه حل اسناد XML

ابزار

  • ابزارهای مستندسازی داده‌های ساخت یافته
  • استفاده از داده‌های ساخت یافته برای مستندسازی

نتیجه

  • مراحل بعدی
۴۰,۰۰۰ تومان