این حالت نمایش چند صفحه ای قابل پرینت این قسمت می‌باشد. برای پرینت کلیک کنید..

بازگشت به حالت نمایش عادی این قسمت.

مستندات

این صفحه به شما نشان می‌دهد چگونه از این پوسته استفاده کنید.

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

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

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

1 - مرور کلی

در اینجا کاربران شما متوجه می‌شوند که آیا پروژه شما برای آن‌ها مناسب است یا نه.

این یک صفحه جایگزین است که به شما نشان می‌دهد چگونه از این سایت الگو استفاده کنید.

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

سعی کنید به این سوالات برای کاربر خود در این صفحه پاسخ دهید:

این چیست؟

پروژه خود را معرفی کنید، از جمله کاری که انجام می‌دهد یا به شما اجازه می‌دهد انجام دهید، چرا باید از آن استفاده کنید، و هدف اصلی آن (و چگونه به آن دست می‌یابد). این باید شبیه به توضیحات README شما باشد، اگرچه می‌توانید در صورت تمایل به جزئیات بیشتری در اینجا بپردازید.

چرا می‌خواهم آن را داشته باشم؟

به کاربران خود کمک کنید بدانند آیا پروژه شما به آن‌ها کمک می‌کند یا نه. اطلاعات مفید می‌تواند شامل موارد زیر باشد:

  • برای چه خوب است؟: چه نوع مشکلاتی را پروژه شما حل می‌کند؟ مزایای استفاده از آن چیست؟

  • برای چه خوب نیست؟: به عنوان مثال، شرایطی را ذکر کنید که ممکن است به صورت شهودی مناسب پروژه شما به نظر برسد، اما به دلایلی مناسب نیست. همچنین محدودیت‌های شناخته شده، مشکلات مقیاس‌پذیری، یا هر چیز دیگری که ممکن است به کاربران شما بگوید که پروژه برای آن‌ها نیست را ذکر کنید.

  • برای چه هنوز خوب نیست؟: هر ویژگی مفیدی که به زودی می‌آید را برجسته کنید.

بعد کجا باید بروم؟

گام‌های بعدی را از مرور کلی به کاربران خود بدهید. به عنوان مثال: