مستندات الگو

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

میانبر: وپ:مستند

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

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

توضیحات الگو باید شامل این موارد را پوشش دهد:

• هدف اساسی از ساخت الگو
• پارامترهای‌های الگو
• نمونهٔ به کارگیری
• الگوهای مرتبط
• رده‌ها و پیوندهای میان‌ویکی: که باید در قالب … قرارگیرند.

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

ابتدا الگوی زیر را در صفحه اصلی الگو قرار دهید.(کپی کنید)

}}

سپس روی /توضیحات که قرمز رنگ است تلیک می کنید و بعد روی ایجاد صفحه بزنید.

• برای قراردادن خود الگو در رده، کد [[رده:چگونه‌های ویکی‌پدیا]] [[رده:الگوهای ویکی‌پدیا]] [[رده:توضیحات الگو]] [[رده:نام رده]] درون یک ... قسمت از زیر صفحه توضیحات اضافه کنید.
• برای قراردادن یک پیوند میان‌ویکی در خود الگو، کد [[کدزبان:نام الگو]] را درون یک قسمت ... در زیرصفحهٔ توضیحات اضافه کنید.
• برای قراردادن زیرصفحهٔ توضیحات درون یک رده، کد [[رده:نام رده]] را درون یک قسمت ... در صفحهٔ توضیحات اضافه کنید.
• برای قراردادن مقالات استفاده کننده از الگو در یک رده، کد [[رده:نام رده]] درون یک قسمت ... در صفحه الگو اضافه کنید.

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

• ویکی‌پدیا:الگوهای حساس