راهنمای نویسنده فنی

فاز فعلی:
برنامه Season of Docs 2019 در 6 مارس 2020 به پایان رسید. جدول زمانی را ببینید.

این صفحه حاوی راهنمای نویسندگان فنی است که در Season of Docs شرکت می کنند.

معرفی

به فصل اسناد خوش آمدید! این راهنما مقداری در مورد مشارکت شما در Season of Docs به شما می گوید و به شما در فعالیت هایی که باید در هر مرحله از برنامه انجام دهید کمک می کند.

واجد شرایط بودن برای شرکت در Season of Docs

برای شرکت در Season of Docs به عنوان یک نویسنده فنی، باید:

  • حداقل 18 سال سن در زمان ثبت نام.
  • قادر به نشان دادن تجربیات فنی قبلی با ارائه توضیحات نقش و نمونه کار.
  • واجد شرایط کار در کشور محل اقامت خود در طول مدت برنامه.
  • مقیم کشوری که در حال حاضر توسط ایالات متحده تحریم نشده است. به برنامه های تحریم ها و اطلاعات کشور از خزانه داری ایالات متحده مراجعه کنید.

شرایط کامل نویسنده فنی را ببینید.

مربیان منبع باز شما

مربیان Season of Docs لزوما نویسندگان فنی نیستند و ممکن است تجربه کمی در ارتباطات فنی داشته باشند. آنها اعضای سازمان منبع باز هستند که ارزش اسناد خوب را می دانند و در فرآیندها و ابزارهای منبع باز تجربه دارند.

رابطه بین شما و مربیانتان یک همکاری است. شما تجربه و مهارت های مستندسازی را به سازمان منبع باز می آورید. مربیان شما دانش خود را در مورد منبع باز و کد به اشتراک می گذارند. با هم، می توانید اسناد فنی را توسعه دهید و فرآیندهای پروژه منبع باز را بهبود بخشید.

مراحل اعلام برنامه و درخواست سازمان

تاریخ اعلام فصل اسناد 11 مارس 2019 است. سازمان های منبع باز علاقه مند می توانند برای شرکت در فصل اسناد بین 2 آوریل 2019 تا 23 آوریل 2019 درخواست دهند. مدیران برنامه Google لیست سازمان های موفق را در 30 آوریل منتشر می کنند. ، 2019.

در فاصله زمانی بین اعلام برنامه و انتشار سازمان های متن باز شرکت کننده، باید مراقب اخبار باشید. می توانید به این وب سایت بازگردید و همچنین پست های وبلاگ یا اخبار دیگر را در وب مشاهده کنید. برخی از سازمان های منبع باز ممکن است ایده های خود را حتی در مرحله درخواست سازمان به اشتراک بگذارند.

ما همچنین از شما دعوت می کنیم تا در مورد Season of Docs و دلیل علاقه مندی خود به این برنامه صحبت کنید. نگاهی به مواد تبلیغاتی برای گرافیک و ایده بیاندازید.

مرحله کاوش نویسنده فنی

مرحله کاوش نویسنده فنی از 30 آوریل تا 28 مه 2019 اجرا می شود. در این دوره، می توانید لیست سازمان های شرکت کننده و ایده های پروژه آنها را بررسی کنید.

وقتی یک یا چند پروژه را پیدا کردید که مورد علاقه شماست، باید مستقیماً به سازمان منبع باز مربوطه مراجعه کنید تا درباره ایده های پروژه بحث کنید.

وظایف شما به عنوان نویسنده فنی در این مرحله

فهرست سازمان‌های منبع باز شرکت‌کننده و ایده‌های پروژه آنها را بررسی کنید.

برای یافتن یک سازمان منبع باز که می خواهید با آن کار کنید، فهرست را بررسی کنید. به پروژه های نگارش فنی که سازمان ها پیشنهاد داده اند نگاه کنید و تصمیم بگیرید که کدام پروژه ها برای شما مناسب است. شما می توانید برای بیش از یک سازمان درخواست دهید. در این مرحله از Season of Docs، ایده خوبی است که بیش از یک گزینه را بررسی کنید. فرآیند انتخاب نهایی تنها یک پروژه را برای هر نویسنده فنی می پذیرد.

مشارکت سازمان های منبع باز

در مورد ایده های پروژه با سازمان های منبع باز بحث کنید.

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

مشارکت سازمان های منبع باز

ایده هایی برای پروژه های نوشتاری فنی

مرحله درخواست نویسنده فنی

مرحله درخواست نویسنده فنی از 29 می 2019 تا 28 ژوئن 2019 اجرا می شود. در این دوره، می توانید برای شرکت در Season of Docs درخواست دهید. مدیران برنامه Google جزئیات مربوطه را از برنامه شما به سازمان منبع باز انتخابی شما ارسال می کنند. سپس مدیران و مربیان سازمان منبع باز پروژه هایی را که می خواهند راهنمایی کنند انتخاب می کنند.

وظایف شما به عنوان متقاضی نویسنده فنی در این مرحله

درخواست خود را برای شرکت در Season of Docs ارسال کنید.

درخواست خود را برای Season of Docs قبل از 28 ژوئن 2019 ارسال کنید.

ایجاد اپلیکیشن شما

اپلیکیشن‌های نویسنده فنی Season of Docs 2019 اکنون بسته شده‌اند.

مرحله پیوند جامعه

مرحله پیوند جامعه از 7 آگوست تا 1 سپتامبر 2019 اجرا می شود. در این دوره، مربیان منبع باز به شما کمک می کنند تا با پروژه و جامعه منبع باز آشنا شوید.

وظایف شما به عنوان نویسنده فنی در این مرحله

راه اندازی کانال های ارتباطی

با مربی(های) خود در سازمان منبع باز که برای کار با آن انتخاب کرده اید، تماس بگیرید. اطمینان حاصل کنید که راه مطمئنی برای برقراری ارتباط مستقیم با مربی خود و مدیران سازمان دارید — دومی اعضای سازمان منبع باز هستند که به عنوان مخاطب اصلی Season of Docs برای سازمان خود عمل می کنند.

مسئولیت های شما

مسئولیت های مربیان شما

راهنمای مربیان برای کار با نویسندگان فنی

در پروژه و جامعه منبع باز شرکت کنید.

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

درک کاملی از محصول به دست آورید.

از مربی خود بخواهید محصولی را که به زودی مستندسازی می کنید (به ویژه از نظر مفهومی) توضیح دهد. درباره مخاطبان مستندات به تفصیل بحث کنید.

اهداف و انتظارات را تعیین کنید.

با مربی خود کار کنید تا اهداف پروژه نگارش فنی خود را اصلاح کنید و انتظارات را از هر دو طرف تعیین کنید. تعیین این اهداف و انتظارات در حال حاضر راه خوبی برای اطمینان از موفقیت پروژه شما است.

مرحله توسعه سند

مرحله توسعه سند از 2 سپتامبر 2019 تا 22 نوامبر 2019 اجرا می شود. (تاریخ پایان برای پروژه های طولانی مدت متفاوت است.) در این دوره، شما بر روی پروژه خود با مشورت نزدیک با مربیان خود کار می کنید.

وظایف شما به عنوان نویسنده فنی در این مرحله

برای تکمیل پروژه خود با مربی خود کار کنید.

برای تکمیل پروژه خود از نزدیک با مربی خود همکاری کنید. برای درخواست بازبینی اسناد حاصل و ارسال به‌روزرسانی‌ها به مخزن منبع باز، رویه‌های جامعه منبع باز را دنبال کنید. به عنوان مثال، پروژه های منبع باز میزبانی شده در GitHub با ایجاد یک درخواست کشش برای بررسی و ارسال، فایل ها را اضافه یا به روز می کنند.

هرگونه نگرانی را با مدیر سازمان مطرح کنید.

اگر در مورد ارتباط با مربیان خود نگرانی دارید یا با مشکلات دیگری مواجه شدید که ممکن است بر تکمیل موفقیت آمیز پروژه شما تأثیر بگذارد، به مدیر سازمان منبع باز اطلاع دهید.

مسئولیت های شما

هر نظرسنجی را از مدیران برنامه Google تکمیل کنید.

مدیران برنامه Google ممکن است یک نظرسنجی در اواسط پروژه برای ارزیابی پیشرفت ارسال کنند. نظرسنجی را تکمیل کنید و پاسخ‌های خود را طبق دستورالعمل در سند نظرسنجی به مدیران برنامه Google ارسال کنید.

مرحله نهایی سازی و ارزیابی پروژه

مرحله نهایی سازی پروژه از 25 تا 29 نوامبر 2019 و مرحله ارزیابی از 25 نوامبر تا 6 دسامبر 2019 اجرا می شود. (تاریخ ها برای پروژه های طولانی مدت متفاوت است.) در طول دوره نهایی شدن پروژه، گزارش پروژه خود را ارسال می کنید. ، همچنین محصولات کار نهایی شما نامیده می شود. در طول مرحله ارزیابی، ارزیابی خود را از مربی(های) خود و تجربه خود به عنوان یک شرکت کننده در Season of Docs ارسال می کنید.

وظایف شما به عنوان نویسنده فنی در این مرحله

گزارش پروژه خود را بنویسید

گزارش پروژه خود را بنویسید (گاهی اوقات محصول کار شما نامیده می شود). گزارش پروژه شامل شرح کارهایی است که در طول فصل اسناد انجام داده‌اید و هر پیوند مرتبط.

ایجاد گزارش پروژه شما

فاز نهایی پروژه Season of Docs 2019 بسته شده است.

از مربی خود بخواهید گزارش پروژه شما را بررسی کند.

مربی شما ممکن است بینش ارزشمندی در مورد چگونگی توصیف دستاوردهای شما داشته باشد. همچنین، قبل از اینکه مربی شما پروژه را با موفقیت انجام شده یا خیر علامت گذاری کند، به درک مشترک از وضعیت پروژه در این مرحله مفید است.

گزارش پروژه خود را نهایی کنید

گزارش پروژه خود را تا 28 فوریه 2020 ساعت 18:00 UTC نهایی کنید. فرم قابل ویرایش است، اما باید نسخه نهایی را تا تاریخ معین ارسال کنید.

فاز نهایی پروژه Season of Docs 2019 بسته شده است.

ارزیابی خود را از مربی و تجربه خود از Season of Docs بنویسید و ارسال کنید.

ارزیابی خود را تا 28 فوریه 2020 ساعت 18:00 UTC تکمیل و ارسال کنید.

ارزیابی توسط نویسندگان فنی

مسئولیت های شما

فاز نهایی پروژه Season of Docs 2019 بسته شده است.

پروژه های طولانی مدت

برای پروژه‌های نوشتاری فنی با طول استاندارد در Season of Docs، مرحله توسعه سند از 2 سپتامبر 2019 تا 22 نوامبر 2019 اجرا می‌شود. با این حال، برخی از نویسندگان فنی ممکن است برای یک پروژه طولانی‌مدت با مشورت سازمان منبع باز درخواست دهند. برای یک پروژه طولانی مدت، مرحله توسعه سند از 2 سپتامبر 2019 تا 21 فوریه 2020 اجرا می شود.

دوره نهایی سازی و ارزیابی پروژه برای پروژه های بلند مدت 24 تا 28 فوریه 2020 است.

وظایف و مسئولیت های شما همان است که در این صفحه برای پروژه های نوشتاری فنی با طول استاندارد توضیح داده شده است، با این تفاوت که تاریخ نهایی شدن پروژه و ارزیابی ها بعد از آن است.