پروژه کولیبری

این صفحه حاوی جزئیات یک پروژه نگارش فنی است که برای فصل اسناد Google پذیرفته شده است.

خلاصه پروژه

سازمان منبع باز:
کولیبری
نویسنده فنی:
دانیل وی
نام پروژه:
گردش کار محتوای Kolibri
طول پروژه:
دویدن طولانی مدت (5 ماه)

شرح پروژه

پیشنهاد زیر با انجام تحقیق و گفتگو با مربیان کولیبری ایجاد شده است. گفتگوی من با مربیان به من کمک کرد تا پرسونای کاربری را که در زیر به آنها می پردازم توسعه دهم. علاوه بر این، بحث‌های من به من کمک کرد تا به ایده یک مخزن آموزشی/صفحه فرود بیایم تا کاربران انتخاب کنند که کدام آموزشی را می‌خواهند برای نیازهای خود ببینند.

نمای کلی

این پیشنهاد راه حلی را برای هدایت سفرهای مختلف کاربر ارائه می دهد که یک فرد می تواند محتوا را از رایانه خود به استودیو کولیبری و سپس از استودیو کولیبری به کولیبری وارد کند. من پیشنهاد می کنم یک مخزن مرکزی از آموزش ها ایجاد شود. کاربر از طریق صفحه فرود به این آموزش ها دسترسی خواهد داشت. صفحه فرود جدولی با پیوندهایی به هر آموزش گردش کار ارائه می دهد و نوع کاربری را که آموزش می تواند از آن بهره مند شود را نشان می دهد. به این ترتیب، آموزش ها بیشتر با نیازها و توانایی های کاربر شخصی سازی می شوند. یک گردش کار (به عنوان مثال، INSTALL-IMPORT) با چندین درس نشان داده می شود. هر درس حاوی یک ویدیو است. ویدئوها بخش کوچکی از گردش کار را نشان می‌دهند و مفاهیم فردی را در مورد نحوه اتصال این گردش‌ها به برنامه‌های Kolibri نشان می‌دهند.

اهداف اصلی

  1. یک صفحه فرود آموزشی ایجاد کنید که به کاربران کمک می کند تصمیم بگیرند که کدام گردش کار به بهترین وجه با نیازهای آنها مطابقت دارد. این صفحه فرود در پلتفرم Read the Docs میزبانی خواهد شد.

  2. برای اجزای هر گردش کار درس های فردی ایجاد کنید و درس های دشوار را با تمرین ها تکمیل کنید.

  3. برای هر گردش کار ویدیوهای تعاملی ایجاد کنید.

ابزار پروژه

کار با استفاده از نرم افزار اسکرین کست انجام خواهد شد. من تجربه کار با Camtasia را دارم، اما با نرم افزارها و نرم افزارهای رایگان کم هزینه تر نیز کار کرده ام. نمونه ویدیویی که در اینجا ( https://youtu.be/DkMP_VdGslU ) لینک شده است با فلش بک توسط نرم افزار بلوبری ساخته شده است که من در حال حاضر مجوز آن را دارم. من با استفاده از یوتیوب زیرنویس ایجاد خواهم کرد. صفحات آموزشی در سایت Read the Docs کولیبری میزبانی خواهد شد. کار پیش‌نویس در Google Docs تکمیل خواهد شد و من می‌توانم در تبدیل فایل‌های متنی به Markdown یا ReStructuredText برای محصول نهایی کمک کنم.

جدول زمانی

این پروژه از دستورالعمل های پروژه بلندمدت پیروی می کند (در مجموع 26 هفته، از 9/2/2019-2/28/2020). من حدود 10 ساعت در هفته را صرف تکمیل اهدافی خواهم کرد که در زیر به آنها اشاره شده است. علاوه بر این اهداف، در این مدت در صورت نیاز در جلسات و ارتباطات راهنما شرکت خواهم کرد. من با مربیان کار خواهم کرد تا بهترین زمان را برای این کار تعیین کنیم. جدول زمانی به طور کلی به بخش‌های چهار هفته‌ای تقسیم می‌شود که در آن چندین ویدیو، صفحات آموزشی و تمرین‌ها ایجاد خواهم کرد.

هفته اول و دوم

اهداف:

  • دستگاه شخصی را با هر وب سایت یا حساب مورد نیاز برای دسترسی به اطلاعات تنظیم کنید.
  • شروع به توسعه ساختار و چارچوب دقیق تر برای صفحه فرود کنید.
  • با مربیان در مورد سبک ویدیوها بحث کنید، همچنین یک الگوی صفحه باز کردن ویدیو، هر موسیقی پرکننده برای صفحه‌های عنوان و پایان، و اطلاعات اضافی که باید گنجانده شود، ایجاد کنید.
  • اسناد و ساختار اسناد فعلی را برای استخراج پیوندها برای استفاده در منابع اضافی و مراجع آموزشی مرور کنید.

هفته های سوم تا ششم (سطح 1 - آموزش های مبتدی)

اهداف:

  • محتوا و درس های اولیه را برای گردش کار INSTALL-IMPORT/Level 1 توسعه دهید. برای فرآیندهای دانلود، نصب، پیکربندی و وارد کردن ویدیو ایجاد کنید. از آنجایی که توابع INSTALL-IMPORT پایه و اساس بسیاری از گردش‌های کاری دیگر هستند و معمولاً مورد استفاده قرار می‌گیرند، بخش زیادی از زمان به نهایی کردن این آموزش‌ها و درس‌ها اختصاص می‌یابد.
  • بر روی انواع مکان IMPORT تمرکز کنید و گرافیکی را ایجاد کنید که نمونه ای برای کاربر باشد که در آن می تواند محتوا (کانال های عمومی موجود در استودیو Kolibri) را برای صفحه فرود به دست آورد.
  • ویدیوها و محتوای اضافی را برای گسترش INSTALL-IMPORT (کانال به روز رسانی) توسعه دهید. این توسعه‌ها همچنین می‌توانند به شکل منابع اضافی یا پیوندهایی به اسناد موجود باشند.
  • برای هر ویدیویی روی زیرنویس کار کنید.
  • ویدیوها را «آزمایش» کنید و از منابع موجود در مورد قابلیت استفاده بازخورد بخواهید. این شامل بازدید مجدد از الگوی ویدیوها و استحکام بخشیدن به الگو برای ویدیوهای آینده است.

هفته های هفتم تا دهم (سطح 2- آپلودکننده محتوا)

اهداف:

  • روی درس ها و ویدیوهای گردش کار برای شخصیت استودیو آپلودکننده تمرکز کنید.
  • مستندات و دروس کامل برای UPLOAD-PUBLISH-IMPORT.
  • برای هر ویدیویی زیرنویس ایجاد کنید.

هفته یازده تا چهاردهم (سطح 3 - "ریمیکسر" محتوا و ویرایشگر)

اهداف:

  • روی گردش کار زیر تمرکز کنید و محتوای آموزشی/درسی ایجاد کنید: UPLOAD-EDIT-PUBLISH-UPDATE و EDIT-PUBLISH-UPDATE.
  • هر زیرنویسی برای ویدیوها ایجاد کنید.

هفته پانزده تا هجده

اهداف:

  • همانطور که در طول تحقیق من برای این پیشنهاد بیان شد، جریان های کاری مربوط به Ricecooker دارای اولویت پایین تری هستند (نوع CHEFDEV). بسته به زمان و برنامه، می توانم از این زمان برای ایجاد یک آموزش سطح بالا استفاده کنم که به مستندات موجود برای Ricecooker اشاره دارد.

هفته های نوزدهم تا بیست و دوم

اهداف:

  • هر شکافی را در این زمان ارزیابی کنید و جریان فعلی همه آموزش ها را آزمایش کنید.
  • روی نهایی کردن صفحه فرود کار کنید و شروع به پیوند دادن ویدیوها به یکدیگر کنید.
  • از طریق تبدیل پیش‌نویس‌های صفحه انجام شده در Google Docs به Markdown یا ReStructuredText، همانطور که با مربیان بحث شد، کار کنید.

هفته های بیست و سوم تا بیست و پنجم

اهداف:

  • بسته به زمان، هر کار نهایی را با آموزش های پیشرفته و کم اولویت تمام کنید.
  • آخرین لحظه ویرایش صفحه Docs، آزمایش فایل، گرامر/املا را بخوانید.
  • QA برای هر پیوندی در ویدیوها یا صفحات دیگر.

هفته بیست و ششم

هفته آخر پروژه های بلند مدت من با مربیان کار خواهم کرد تا موارد قابل تحویل پروژه را جمع بندی کنم و اسناد نهایی و مورد نیاز Google را تکمیل کنم.

اجزای آموزشی

صفحه فرود آموزش

کاربران به صفحه فرود آموزشی در سایت Kolibri's Read the Docs دسترسی خواهند داشت که خلاصه ای از آموزش های مختلف ارائه شده برای گردش کار محتوا را ارائه می دهد. هدف از این صفحه ارائه یک نمای کلی از اکوسیستم کولیبری و همچنین ارائه یک نمای گرافیکی از گردش کارهای مختلف است. این به کاربر این امکان را می دهد که نوع گردش کاری را که متناسب با نیازهای او است، هم از نظر فنی و هم برای برنامه درسی سازمانش مشاهده کند. کاربران درک بیشتری از گزینه های موجود در Kolibri و Kolibri Studio خواهند داشت.

صفحات آموزشی و درس

هر صفحه اصلی آموزش مقدمه ای برای آموزش (شامل چندین درس) و به دنبال آن برخی از اهداف کاربر ارائه می دهد. آموزش ها کل گردش کار را نشان می دهند و از درس های فردی تشکیل شده اند. هر درس یک ویدیو خواهد داشت. ویدئوها بخشی از یک مفهوم کلی را پوشش خواهند داد. هر درس در یک صفحه جداگانه در صفحه اصلی گردش کار آموزشی نگهداری می شود. صفحات درس دارای دکمه هایی هستند که به کاربر اجازه می دهد تا به درس قبلی یا بعدی در داخل آموزش حرکت کند. مفاهیم بسیار پیچیده می تواند شامل فعالیت های تمرینی باشد.

فیلم ها و ساختار

ویدئوها یک مفهوم واحد را ترسیم می کنند. هنگام انجام آن عمل روی صفحه، ویدیوها جهت می دهند. یک نمونه ویدیو را می‌توانید در اینجا پیدا کنید: https://youtu.be/DkMP_VdGslU . این نمونه ویدیو نحوه استفاده از جادوگر تسهیلات راه اندازی را نشان می دهد.

این ویدیو از فراخوان‌ها و یک مکان‌نمای برجسته استفاده می‌کند تا به راهنمایی کاربر در مراحل این مفهوم واحد کمک کند. ویدئوها در یوتیوب میزبانی خواهند شد. اگر در یوتیوب میزبانی شود، زیرنویس ها به طور خودکار ایجاد می شوند. سپس شرح‌ها را برای املا، دستور زبان و نقطه‌گذاری ویرایش می‌کنم. سپس می‌توان آن زیرنویس‌ها را برای ترجمه در Amara یا ابزار ترجمه دیگری صادر کرد.

ویدیوها صفحه عنوان ثابتی خواهند داشت که من قصد دارم در چند هفته اول با مربیان صحبت کنم. من همچنین از یک سبک فراخوانی ثابت (فلش‌ها، برجسته مکان‌نما، کادرها) استفاده می‌کنم که در چند هفته اول با مربیان تصمیم‌گیری می‌شود.

نمونه سازه ها

ساده ترین گردش کار، INSTALL-IMPORT، یک آموزش کامل است. در داخل آن آموزش، دو درس بالقوه با یک ویدیو وجود دارد:

  • دانلود، نصب و راه اندازی تسهیلات Kolibri شما
  • وارد کردن محتوا در استودیو کولیبری - توجه داشته باشید که این ویدیو توسط سایر گردش کارها ارجاع خواهد شد

یک آموزش پیشرفته تر به چندین درس فرعی با چندین ویدیو نیاز دارد. گردش کار UPLOAD-EDIT-PUBLISH-UPDATE از ساختار زیر پیروی می کند.

درس 1 – آپلود محتوا و ایجاد کانال در استودیو کولیبری

اهداف کاربر: در پایان این درس، نحوه انجام اقدامات زیر را خواهید آموخت:

  • ایجاد کانال در استودیو کولیبری برای استفاده در کولیبری. شما می دانید که چگونه از رمزهای مخفی کانال خود برای وارد کردن کانال محتوای خود در کولیبری استفاده کنید.
  • با وارد کردن محتوا از کانال‌های موجود و عمومی در کتابخانه استودیو، یک کانال ایجاد کنید.
  • با آپلود محتوا از رایانه خود یک کانال ایجاد کنید.

فیلم های درس فرعی:

  • درس فرعی 1 - کانال های خود را در استودیو کولیبری ایجاد کنید و محتوا را از کانال های عمومی موجود (خان آکادمی، PHET و غیره) وارد کنید: ویدیو 1 - کانال های محتوای عمومی (مشاهده کانال های عمومی در استودیو کولیبری) ویدیو 2 - ایجاد یک کانال ویدیو 3 – وارد کردن محتوا از کانال های موجود ویدئو 4 – انتشار کانال و به دست آوردن رمز مخفی ویدئو 5 – وارد کردن کانال خود به کولیبری با استفاده از رمز مخفی
  • درس دوم - آپلود کانال محتوای اسناد من: ویدئو 1 - آپلود فایل ها از فیلم اسناد من 2 - ایجاد تمرین های خود

درس 2 – ویرایش پیشرفته کانال ها در استودیو کولیبری

اهداف کاربر: در پایان این درس، نحوه انجام اقدامات زیر را خواهید آموخت:

  • ویرایش کانال های محتوا در استودیو کولیبری
  • کانال های محتوا را در استودیو کولیبری مدیریت کنید

فیلم های درس فرعی:

  • درس فرعی 1- ویرایش محتوا با افزودن تمرین ها، سازماندهی مجدد ساختار پوشه و گزینه های همکاری (1 ویدیو)
  • درس فرعی 2 - استفاده از عملکردهای دیگر مانند حذف / انتقال محتوا (1 ویدیو)

درس 3 – انتشار کانال های استودیو کولیبری برای استفاده در کولیبری و به روز رسانی کانال ها

اهداف کاربر: در پایان این درس، نحوه انجام اقدامات زیر را خواهید آموخت:

  • کانالی را در استودیو کولیبری منتشر کنید و پس از اضافه شدن مطالب جدید دوباره منتشر کنید
  • یک کانال را به روز کنید
  • دریافت رمز کانال برای وارد کردن به کولیبری (از طریق پیوند به ویدیوی قبلی در درس 1 که این عمل را پوشش می‌دهد)

فیلم های درس فرعی:

  • درس فرعی 1 - انتشار به روز رسانی در یک کانال

    ویدئو 1: بازنشر کانال ویدئو 2: به روز رسانی کانال در کولیبری پس از افزودن مطالب اضافی