خانه
بازگشت به مستندات

راهنمای محصول

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

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

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

بازنویسی دقیقاً کجا دیده می‌شود

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

کشوی «راهنمای صفحه» در پنل، متن‌هایی را می‌خواند که همراه خودِ نسخه نصب شده‌اند — نه پایگاه داده. این عمدی است: راهنما باید بدون پایگاه داده، بدون شبکه و بدون سرویس هوش مصنوعی هم کار کند. نتیجهٔ ناخواسته‌اش این است که بازنویسی به کشوی راهنما نمی‌رسد؛ آن متن تا انتشار نسخهٔ بعد همان می‌ماند که بود.

هر فیلد جداگانه برمی‌گردد

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

«بازنویسی کهنه» یعنی چه

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

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

جست‌وجو هم اصلاح شما را می‌بیند

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

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

هر فیلدی که بازنویسی نکرده‌اید، به همان شکل منتشرشده قابل جست‌وجو می‌ماند — فقط عنوان را عوض کنید و واژه‌های متن همچنان مقاله را پیدا می‌کنند.

این رفتار مربوط به سایت عمومی مستندات است. کشوی راهنما در پنل، متن‌هایی را که همراه نسخه منتشر شده‌اند جست‌وجو می‌کند، به همان دلیلی که بالاتر آمد.