پرسش‌های متداول

مجموعه‌ای از پرسش‌های متداول


چه کسانی پشت Exercism هستند؟

دو هم‌بنیان‌گذار Exercism، Katrina Owen و Jeremy Walker هستند.

Exercism در ابتدا توسط Katrina بنیان‌گذاری شد؛ توسعه‌دهنده‌ای چندزبانه و برنده‌ی جایزه‌ی «Ruby Hero» که در حین تحصیل در رشته‌ی زیست‌شناسی مولکولی، به‌طور تصادفی برنامه‌نویس شد. او در سال ۲۰۰۶، وقتی در JavaRanch داوطلب بود، شروع به خرده‌گیری از کدها کرد و به آن علاقه‌مند شد. حین برنامه‌نویسی، تمرکز او روی خودکارسازی، بهینه‌سازی گردش کار و بازآرایی است. او به نرم‌افزار متن‌باز اهمیت زیادی می‌دهد و در چند پروژه بیرون از Exercism مشارکت می‌کند.

در سال ۲۰۱۶، Jeremy به‌عنوان هم‌بنیان‌گذار به Exercism پیوست و اکنون مدیرعامل Exercism است. Jeremy کارآفرین اجتماعی و توسعه‌دهنده‌ی نرم‌افزار است و به برابری و ایجاد فرصت برای همه دلبستگی دارد. او علاوه بر Exercism، هم‌بنیان‌گذار پلتفرم سلامت و تیم‌سازی یعنی Kaido است.

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

درباره‌ی منتورها، نگهدارندگان مسیر و هزاران مشارکت‌کننده ما بیشتر بدانید.

ماجرای نام «Exercism» چیست؟

نام آن با اینکه فقط یک واکه با «exorcism» فاصله دارد، هیچ ربطی به دیو و جن یا اصلاح «کد شیطانی» ندارد.

در عوض، بازی با کلمات روی واژه‌ی exercise است. Katrina به هر تمرین این‌طور نگاه می‌کرد که کوچک، جزئی و به‌ظاهر ساده است. اما وقتی پای حل یک تمرین به میان می‌آید، معمولاً شیطان در جزئیات است. به عبارت دیگر، همان تمرین ساده به‌محض اینکه به جزئیات دقیق‌تر فکر کنید، ناگهان چالش‌برانگیزتر می‌شود.

برای اینکه بیشتر بدانید «شیطان در جزئیات» یعنی چه، سخنرانی‌های Katrina با نام Here Be Dragons و One Small Step را ببینید.

مبانی

گم شده‌ام. کجا بروم؟

خوش‌شانس هستید. این راهنمای گام‌به‌گام به شما کمک می‌کند شروع کنید.

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

وقتی می‌خواهم وارد شوم، خطای «Sorry, we could not authenticate you from GitHub» را می‌گیرم. چه کار کنم؟

این یعنی GitHub نمی‌خواهد هویت شما را تأیید کند. ممکن است به این دلیل باشد که اجازه‌ی دسترسی نداده‌اید، یا اینکه حساب GitHub شما درست تنظیم نشده است. یک مشکل رایج این است که نشانی ایمیل خود را در GitHub تأیید نکرده‌اید. می‌توانید این را در تنظیمات ایمیل GitHub بررسی کنید.

چطور حسابم را حذف کنم؟

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

برای حل یک تمرین باید چه کار کنم؟

وقتی کار روی یک تمرین را شروع می‌کنید، یک «راه‌حل استاب» دارید که باید کاملش کنید و یک مجموعه‌ی آزمون کامل هم در اختیار دارید که نیازهایی را نشان می‌دهد که راه‌حل شما باید برآورده کند. این روش توسعه، گونه‌ای از توسعه‌ی آزمون‌محور است.

چطور تمرین‌ها را باز کنم؟

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

ما توصیه می‌کنیم برای پیشرفت در یک مسیر از حالت یادگیری استفاده کنید، اما می‌توانید به حالت تمرین بروید تا همه‌ی تمرین‌ها باز شوند. برای اطلاعات بیشتر، باز کردن تمرین‌ها را ببینید.

چرا تمرین‌های بازشده‌ام در سایت قدیمی قفل شده‌اند؟

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

حالت یادگیری، حالت پیش‌فرض هر کاربری است که از نسخه‌ی قبلی Exercism استفاده کرده است. به همین دلیل، کاربرانی که برمی‌گردند ممکن است ببینند تمرین‌هایی که پیش‌تر در دسترس بودند، اکنون قفل شده‌اند.

ما توصیه می‌کنیم برای پیشرفت در یک مسیر از حالت یادگیری استفاده کنید، اما می‌توانید به حالت تمرین بروید تا همه‌ی تمرین‌ها باز شوند. برای اطلاعات بیشتر، باز کردن تمرین‌ها را ببینید.

کلاینت خط فرمان Exercism

نمی‌توانم ارسال کنم! چه کار کنم؟

سایت جدید یک کلاینت خط فرمان کاملاً تازه دارد و به فراداده‌ی اضافی برای تمرین شما هم نیاز دارد. درباره‌ی اینکه چطور کلاینت خط فرمان خود را ارتقا دهید و راه‌حل‌هایتان را برای سایت جدید منتقل کنید بخوانید.

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

چطور نسخه‌ی کلاینت خط فرمانم را بررسی کنم؟

دستور نسخه، یعنی exercism version، نسخه‌ی در حال اجرای کلاینت خط فرمان Exercism را نمایش می‌دهد. با اجرای دستور نسخه همراه با پرچم latest یعنی exercism version --latest می‌توانید بررسی کنید که آیا نسخه‌ی جدیدتری موجود است.

چطور به آخرین نسخه‌ی کلاینت خط فرمان ارتقا دهم؟

دستور exercism upgrade در صورت وجود نسخه‌ی موجود جدیدتر، کلاینت خط فرمان را به آخرین نسخه ارتقا می‌دهد.

هنگام ارتقا خطاهای «permission denied» می‌گیرم! چه کار کنم؟

اگر هنگام ارتقای کلاینت خط فرمان خطاهای «permission denied» می‌گیرید، به احتمال زیاد فایل اجرایی آن با یک مدیر بسته‌ی سیستمی (مثلاً Homebrew) نصب شده است یا در پوشه‌ای نصب شده که دیگر دسترسی نوشتن به آن را ندارید.

اگر کلاینت خط فرمان شما با یک مدیر بسته نصب شده است، لطفاً برای ارتقا از همان مدیر بسته استفاده کنید و نه از دستور exercism upgrade.

اگر کلاینت خط فرمان شما به‌صورت دستی نصب شده است، لطفاً مسیر کلاینت خط فرمان Exercism را بررسی کنید؛ با which exercism در لینوکس و macOS و با where exercism در ویندوز. مطمئن شوید که مسیر بازگشتی، پوشه‌ای است که خودتان ساخته‌اید. اگر چنین بود، با ابزارهایی که سیستم‌تان در اختیارتان می‌گذارد دسترسی‌های پوشه را تغییر دهید تا به کاربر شما دسترسی نوشتن داده شود و سپس دوباره ارتقا را امتحان کنید. اگر مطمئن نیستید که پوشه را خودتان ساخته‌اید، یا مسیر بازگشتی یک مسیر سیستمی است، لطفاً با ابزارهای سیستم‌تان کلاینت خط فرمان را حذف و با استفاده از آموزش تعاملی دوباره نصب کنید.

بعد از ارتقا در ویندوز، کادر خطای «16-bit MS-DOS Subsystem» را می‌گیرم. چه کار کنم؟

پیش از نسخه‌ی 3.0.5 کلاینت خط فرمان Exercism، یک اشکال در دستور ارتقا وجود داشت که فایل اجرایی کلاینت خط فرمان را با یک فایل متنی تکی جایگزین می‌کرد و باعث خطای «16-bit MS-DOS Subsystem» می‌شد. برای حل این مشکل، فایل اجرایی خراب را حذف کنید و کلاینت خط فرمان را با استفاده از آموزش تعاملی دوباره نصب کنید.

حالت منتورینگ

صف من مدتی است به‌روز نشده؛ مشکلی هست؟

مدت انتظار بنا به دلایل مختلفی (تعداد منتورها، زمان سال) می‌تواند بیش از حد معمول باشد، اما ممکن است این‌طور به نظر برسد که صف به‌روز نمی‌شود. این غیرعادی نیست و باید به‌زودی پیشرفتی ببینید. اگر انتظار شما بسیار بیش از حد میانگین است، به بخش باز کردن یک مسئله در پایین مراجعه کنید.

مسیر من چند منتور دارد؟ در سایت فقط چند نفر را می‌بینم.

سایت فقط منتورهایی را نشان می‌دهد که اطلاعات زندگی‌نامه برای سایت ارائه داده‌اند، نه تعداد واقعی منتورهایی که فعالانه راه‌حل‌ها را بررسی می‌کنند. خیالتان راحت باشد، منتورهایی هستند که در حال رسیدگی به صف‌های خودشان‌اند؛ پس صبر کنید!

راه‌حل یا فایل اشتباهی را ارسال کردم. چه کار کنم؟

در صفحه‌ی همان تمرین، به «تکرارهای شما» بروید. اگر تکرار ناخواسته جمع شده است، روی فلش دایره‌ای کلیک کنید. در منوی «نقطه‌ها»، گزینه‌ی «حذف تکرار» را انتخاب کنید.

چطور می‌توانم سوءرفتار یا نمونه‌های منتورینگ بد را گزارش کنم؟

لطفاً برای اطلاعات بیشتر درباره‌ی انتظارات ما از رفتار، آیین‌نامه‌ی رفتاری ما را ببینید. اگر می‌خواهید چیزی را گزارش کنید، لطفاً با ما از طریق abuse@exercism.org تماس بگیرید؛ ما تلاش می‌کنیم مسئله را با احترام به شما و حفظ حریم خصوصی‌تان حل کنیم.

چرا نمی‌توانم درباره‌ی بازنمایی‌ها بازخورد بدهم؟

برای دادن بازخورد درباره‌ی بازنمایی‌های یک مسیر، باید این سه معیار را داشته باشید:

  1. در حال منتورینگ آن مسیر باشید
  2. حداقل ۱۰۰ گفت‌وگوی تمام‌شده برای آن مسیر را منتورینگ کرده باشید
  3. امتیاز رضایت کلی حداقل ۹۵٪ داشته باشید

بهبود Exercism

عالی است! چطور مشارکت کنم؟

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

مسیرهای زبانی جدید چطور به سایت اضافه می‌شوند؟

یک مسیر زبانی جدید زمانی ساخته می‌شود که یکی از اعضای انجمن رهبری آن را به دست بگیرد و نگهدارندهی آن مسیر شود. اگر می‌خواهید در راه‌اندازی یکی از آن‌ها کمک کنید، راهنمایی‌هایی اینجا هست.

وقتی چیزی اشتباه است، به ما بگویید

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

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

اگر مسئله‌ی من اینجا یا در انجمن فهرست نشده باشد چه؟

اگر مشکل شما حل یا گزارش نشده است، یک نوشته‌ی جدید در انجمن بسازید.

حتماً اطلاعات زیر را ذکر کنید:

  1. خروجی دستور exercism troubleshoot (برای مسائل مربوط به CLI)
  2. جزئیات مسئله‌ای که تجربه می‌کنید
  3. دستورالعمل‌های بازتولید مسئله
  4. در صورت لزوم، ارجاع به هر مسئله‌ی مرتبط با استفاده از شماره‌ی آن (با قالبی مانند #1203)

اگر مسئله‌ای درباره‌ی زبان در سایت وجود داشته باشد چه؟

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

اگر غلط تایپی دیده‌اید یا پیشنهادی برای روان‌تر شدن زبان یا دستورالعمل‌های سایت عمومی دارید، لطفاً یک موضوع جدید در انجمن با اطلاعات زیر بسازید:

  1. پیوند به صفحه‌ای که مسئله در آن است
  2. توضیح اینکه اشتباه چیست یا چه چیزی مبهم است
  3. تغییر پیشنهادی شما