روش تهیهی مطالب پیکوگاید
مطالب پیکوگاید چطور تهیه، با منبع رسمی تطبیق داده، بازبینی و به روز میشوند، و اگر خطایی پیدا شود چه اتفاقی میافتد.
هدف هر مطلب پیکوگاید این است که خوانندهی فنی با آن کارش را درست انجام دهد. این صفحه توضیح میدهد مطالب چطور آماده میشوند تا بدانید به چه چیزی میتوانید تکیه کنید.
۱. منابع
هر عدد، نسخه، پیش فرض، مسیر منو و دستور باید منبع داشته باشد. ترتیب اولویت منابع:
- مستندات رسمی و datasheet وندور، یادداشتهای انتشار و راهنماهای پیکربندی
- RFC و استانداردها (IEEE، TIA، ISO/IEC)
- رسانههای فنی معتبر، فقط برای رخدادهای امنیتی و خبرها
- فرومها و تجربهی کاربران، فقط برای نکتههای عملی و با ذکر همین موضوع
منابع هر مقاله پایین همان صفحه فهرست شدهاند. ادعایی که با منبع تأیید نشود، در متن نمیماند.
۲. تهیهی پیش نویس
پیش نویس مطالب با کمک ابزارهای هوش مصنوعی و بر اساس راهنمای نگارش پیکوگاید تهیه میشود. این ابزارها ممکن است اشتباه کنند، به همین دلیل هیچ پیش نویسی بدون مرحلهی بعد منتشر نمیشود.
۳. بازبینی پیش از انتشار
- هر عدد، نسخه و دستور با منبع رسمی تطبیق داده میشود؛ برای موضوعهای تازه، نسخهی فعلی همان روز بررسی میشود.
- دستورها با نحو مستندات رسمی همان نسخه مقایسه میشوند و مثالها از بازههای آدرس مخصوص مستندسازی استفاده میکنند.
- کاری که سرویس را قطع میکند یا داده را پاک میکند، در کادر هشدار میآید.
- لینکهای داخلی و منابع بررسی میشوند.
تاریخ آخرین بازبینی بالای هر مقاله نمایش داده میشود.
۴. به روزرسانی
نسخهها، لایسنسها، مدلهای هوش مصنوعی و قیمت گذاری وندورها زود تغییر میکنند. مطالبی که به زمان وابستهاند یک یادداشت «تاریخ این مطلب» دارند و دورهای دوباره بررسی میشوند. وقتی متن مقالهای عوض شود، تاریخ به روزرسانی کنار تاریخ انتشار میآید.
۵. اصلاح خطا
اگر خطایی گزارش شود یا در بازبینی پیدا شود، متن اصلاح میشود و تاریخ به روزرسانی ثبت میشود. همهی نسخههای قبلی هر مقاله در سیستم نگه داری میشوند. خطاها را از صفحهی تماس گزارش کنید.
۶. مشخصات فنی
مشخصات محصولات در بخش مشخصات فنی و مقایسه از datasheet رسمی وارد میشوند. تا وقتی یک محصول با منبع رسمی تطبیق داده نشده، برچسب «در انتظار بازبینی» دارد و برای موتورهای جستجو نمایه نمیشود.
۷. بیطرفی
در مطالب قیمت، نام فروشگاه و لینک خرید نمیآید. مقایسهها بر اساس مشخصات رسمی و سناریوی کاربرد نوشته میشوند و هر جا گزینهای برای یک سناریو مناسب نیست، همین را صریح میگویند.
به روزرسانی