پرش به محتویات

سند مرده نسازید

کاغذبازی غیرضروری را حذف کنید

دوری از functional spec شروع خوبی است، اما همان‌جا متوقف نشوید. جلوی کاغذبازی اضافه را همه‌جا بگیرید. مگر اینکه سند واقعاً قرار است به چیزی واقعی تبدیل شود، تولیدش نکنید.

بسازید، ننویسید. اگر لازم است چیزی را توضیح دهید، به جای نوشتن سندی طولانی، تلاش کنید آن را mock up و prototype کنید. یک رابط یا prototype واقعی در مسیر تبدیل شدن به محصول واقعی است. اما یک تکه کاغذ، در مسیر سطل زباله است.

مثلاً اگر سند wireframe قرار است متوقف شود و هرگز مستقیماً به طراحی واقعی تبدیل نشود، زحمتش را نکشید. اگر wireframe به‌عنوان wireframe شروع می‌شود و بعد به طراحی واقعی morph می‌شود، انجامش دهید.

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

هیچ‌کس قرار نیست بخواندش

حتی نمی‌توانم بشمارم چند specification چندصفحه‌ای محصول یا سند business requirement کنار تیم توسعه من خاک خورده و خوانده نشده مانده، در حالی که ما کدنویسی می‌کردیم، مشکل‌ها را بحث می‌کردیم، سؤال می‌پرسیدیم و در مسیر user testing انجام می‌دادیم. حتی با توسعه‌دهندگانی کار کرده‌ام که ساعت‌ها ایمیل‌های توصیفی بلند یا سندهای استاندارد کدنویسی نوشته‌اند که آن‌ها هم خوانده نشده‌اند.

وب‌اپ‌ها با مستندات فراوان جلو نمی‌روند. توسعه نرم‌افزار فرایندی مدام در حال تغییر و iterative است که interaction، تصمیم‌های سریع و مسئله‌های غیرقابل‌پیش‌بینی در مسیر دارد. هیچ‌کدام از این‌ها نمی‌تواند یا نباید روی کاغذ ثبت و بسته‌بندی شود.

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

—Gina Trapani، توسعه‌دهنده وب و سردبیر Lifehacker، راهنمای بهره‌وری و نرم‌افزار


منبع اصلی: Don’t Do Dead Documents