روش‌شناسی و اعتبار داده‌ها

هر مناسبت باید از چهار فیلتر رد شود: آیا کاربر عادی انتظار دارد آن را در یک تقویم فارسی ببیند؟ آیا این یک مناسبت است، نه صرفاً یک واقعه تاریخی؟ آیا تقویم را بهتر می‌کند بدون اینکه شلوغش کند؟ آیا دلیل حضورش بدیهی‌ست؟ اگر پاسخ به هر کدام «نه» باشد، مناسبت وارد نمی‌شود.

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

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

هر مناسبت در گاه‌شمار یک سطح اطمینان و وضعیت بررسی دارد. این‌ها چیزی نیستند که پنهان کنیم — بخشی از طراحی هستند.

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

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

این خلاصه نشان می‌دهد هر لایهٔ تعطیلی رسمی از چه نوع منبعی می‌آید و کدام بخش‌ها هنوز سال‌به‌سال باید بازبینی شوند. این فهرست جایگزین جزئیات هر روز نیست؛ فقط نقشهٔ اعتماد فعلی داده‌هاست.

صفحه‌های روز و ماه همین قرارداد اعتماد را نمایش می‌دهند. برچسب‌ها از دادهٔ بررسی‌شده، وضعیت منبع و لایهٔ تعطیلی می‌آیند، نه از متن دستی هر صفحه.

1. تعطیل رسمی

   فقط وقتی با عنوان تعطیل رسمی نمایش داده می‌شود که لایهٔ همان منطقه منبع رسمی قابل اتکا یا فایل سالانهٔ بررسی‌شده داشته باشد.

2. تعطیلی‌های قمری ایران

   برای سال‌های بررسی‌شده به منبع سالانه وصل می‌شوند. سال‌های موقت با همان وضعیت موقت باقی می‌مانند و به‌عنوان بررسی‌شده یا قطعی معرفی نمی‌شوند.

3. مناسبت‌های فرهنگی

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

4. پیوند و یادداشت منبع

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

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

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

اگر منبع‌ها با هم تعارض داشته باشند یا یک ادعا هنوز پشتوانهٔ کافی نداشته باشد، آن مورد موقت می‌ماند، سطح اطمینانش پایین‌تر نمایش داده می‌شود یا تا روشن شدن منبع از نمایش عمومی کنار می‌رود.

گاه‌شمار از کتابخانه jalaali-js برای تبدیل تاریخ و از Intl.DateTimeFormat برای نمایش محلی استفاده می‌کند. ما ادعای دقت تاریخی نامحدود نداریم. بازه اعتبار جدی ما حدوداً ۱۲۰۶ تا ۱۴۹۸ شمسی است. مرزهای بیرون این بازه ممکن است متفاوت باشند.