راهنما


این سند هنگام پیاده‌سازی یک تحلیلگر راهنمایی ارائه می‌کند.

کلیات

  • همه‌ی فایل‌های ارسالی را تحلیل کنید، به‌جز فایل‌های tests، invalidator، editor، example و exemplar.
  • هدف‌تان رسیدن به درستی ۱۰۰٪ نباشد، چون رسیدن به آن تقریباً غیرممکن است. اشکالی ندارد که تحلیلگر نتواند همه‌ی مشکلات را پیدا کند یا بعضی برچسب‌ها را استنتاج نکند.

کامپایل

اگر زبان شما به مرحله‌ای برای کامپایل نیاز دارد، این نکات را در نظر بگیرید:

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

Testing

  • یک مجموعه‌ی test جامع داشته باشید.
  • برای بررسی رفتار تحلیلگر از testهای golden استفاده کنید. این testها باید از ایمیج Docker استفاده کنند که برای بررسی تحلیلگر دیپلوی خواهد شد.
  • در نظر بگیرید که برای هر رویکرد test داشته باشید. می‌خواهید تحلیلگر برای این راه‌حل‌ها خوب کار کند، و این بعداً به تخصیص برچسب‌ها به رویکردها کمک می‌کند.