توضیح پیادهسازی با ثبت مراحل ساخت آن، ساختار متفاوتی میخواهد. فیلیپ کیلی در «Writing for Software Developers» این تفاوت را به مسیر عملی نوشتن تبدیل میکند؛ مسیری با خوانندهی مشخص و دانشی که او لازم دارد.
از موضوع تا انتشار
انتخاب موضوع، شناخت مخاطب، طرح اولیه، پیشنویس، ویرایش، انتشار و یادگرفتن از بازخورد بررسی میشوند. پیشنهاد مقاله به ناشر، رساندن نوشته به مخاطب و جنبهی کاری نوشتن فنی هم در دامنهی کتاب قرار دارند.
شناخت خواننده به این مرحلهها جهت میدهد. آموزش مبتدی، راهنمای مهاجرت و بررسی عمیق برای نگهدارندهی پروژه، پیشنیاز، ریتم و شواهد متفاوت میخواهند. تیتر روشن و مثال، به کسی کمک میکنند که پاسخ را جستوجو میکند، آن را امتحان میکند و بعداً دوباره برمیگردد.
نوشتهی قابلاستفاده
برای توسعهدهندهای که مقاله یا آموزش مینویسد و کسی که نوشتن فنی را بخشی از کارش میبیند، راهنمای عملیای است. ارزش کتاب در عبور از گزارش پیادهسازی به توضیحی است که بر اساس نیاز خواننده شکل گرفته است.
دریافت کتاب
- سایت رسمی: Writing for Software Developers
