فاز فعلی:
جدول زمانی نتایج اعلام شد.
این صفحه حاوی نکاتی برای سازمان های منبع باز در مورد نحوه ارزیابی و انتخاب نویسنده فنی مناسب برای پیشنهاد پروژه Season of Docs است.
معرفی
سازمان های متن باز باید یک نویسنده فنی را برای کار روی پروژه پیشنهادی خود استخدام کنند. سازمان ها باید نویسنده فنی خود را تهیه کنند. نویسندگان فنی علاقه‌مند به کار با سازمان‌های شرکت‌کننده در Season of Docs را می‌توانید در مخزن Season of Docs GitHub و در کانال #season-of-docs در Write the Docs Slack پیدا کنید.
شروع فرآیند
توصیه می شود به محض اینکه فکر می کنید می خواهید در Season of Docs شرکت کنید، روند پیدا کردن یک نویسنده فنی را شروع کنید.
ارزیابی یک نویسنده فنی
توصیه می شود از نویسندگان فنی مورد نظر خود نمونه هایی از مستندات توسعه یافته قبلی را درخواست کنید تا بتوانید بر ارزیابی مهارت ها و تجربه فنی نوشتاری آنها تمرکز کنید.
مهارت و تجربه فنی نوشتاری
تجربه قبلی نویسنده فنی را بررسی کنید. در حالت ایده آل، نویسنده فنی باید تجربه قبلی در نوشتن اسناد فنی برای صنعت نرم افزار داشته باشد. یکی از اهداف Season of Docs این است که به نویسندگان فنی این فرصت را بدهد تا با محصولات متمرکز بر توسعه‌دهنده درگیر شوند. به همین دلیل، ضروری نیست که نویسنده تجربه با APIها یا SDKها یا دیگر پلتفرم‌های توسعه‌دهنده داشته باشد، حتی اگر پروژه شما بر روی مخاطبان توسعه‌دهنده متمرکز باشد.
بر مهارت های زبانی و ارتباطی تمرکز کنید. کار قبلی نویسنده فنی را از این منظر ارزیابی کنید. مهمتر از همه: آیا می توانید بفهمید که آن شخص چه نوشته است؟ اگر می خواهید به بررسی عمیق زبان کار نویسنده فنی بپردازید، به دنبال ثبات در نقطه گذاری و عبارت، املای صحیح و زبان واضح باشید. آیا عبارت ساده است یا پیچیده؟ آیا جملات کوتاه هستند یا آنقدر ادامه می یابند که دنبال کردنشان سخت شود؟
به طراحی و چیدمان سند توجه کنید. طرح کلی نمونه(های) سند را بررسی کنید. آیا طراحی منطقی است؟ آیا می توانید به راحتی راه خود را در مورد اسناد یا مجموعه اسناد پیدا کنید؟ آیا مطالب تکراری وجود دارد یا شکاف های آشکاری وجود دارد؟
استخدام نویسنده فنی
سازمان‌ها باید یک نویسنده فنی استخدام کنند و فرم استخدام نویسنده فنی را که در زیر پیوند داده شده است تا 16 مه 2022 ساعت 18:00 UTC تکمیل کنند.
مرحله استخدام نویسنده فنی تکمیل شد.
قبل از استخدام حتماً در مورد غرامت و برنامه پرداخت با نویسنده فنی صحبت کنید. توصیه می‌کنیم که سازمان‌ها بر اساس نقاط عطف پروژه، از جمله پرداخت در شروع پروژه، یک برنامه پرداخت با نویسندگان فنی ایجاد کنند. لطفاً تاریخ پرداخت را در نظر داشته باشید، که فقط دو بار در طول برنامه انجام می شود، و مبالغ هنگام ایجاد برنامه پرداخت.
توجه: سازمان‌هایی که نویسنده فنی استخدام نکرده‌اند و فرم استخدام نویسنده فنی را تا 16 می 2022 در ساعت 18:00 UTC ارسال نکرده‌اند، در اولین تاریخ پرداخت وجهی دریافت نخواهند کرد.