همانطور که می دانید، سیستم های کامپیوتری به خودی خود دارای هوش نیستند. به عبارت دیگر این گونه از سیستم ها با دنبال کردن و اجرا نمودن سلسله دستورالعمل هایی که توسط برنامه نویس و کاربر به آنها داده میشود، عملیاتی را انجام میدهند. دستورالعملها و یا اصطلاحاً instruction ها، اجزای اصلی تشکیل دهنده یک سیستم نرم افزاری می باشند. لحاظ کردن دستورالعملهای شفاف برای ساختن یک نرم افزار موفق، بسیار مهم است. به عنوان یک برنامه نویس و توسعه دهنده نرم افزار می بایست عادت کنید که دستورالعمل های شفاف بنویسید. ضمناً در این رابطه توصیه میکنیم از بسته ی آموزش ویدئویی ریفکتورینگ در سی شارپ و بسته ی آموزش ویدئویی کدنویسی تمیز: نوشتن کد برای انسان ها استفاده کنید.
به طور کلی برای نوشتن دستورالعمل های شفاف، دو موضوع مختلف مطرح میشود.
در یک زبان برنامه نویسی و یک نرم افزار تولید شده، دستورالعملها و یا expression ها در واقع دنباله ای از عملیات هستند که بر روی عملگر ها و عمل وندهای مختلف، عملیات ریاضی و یا منطقی خاصی را لحاظ میکنند. مثالهایی از expression ها و یا دستورات مختلف شامل موارد زیر هستند:
نوشتن expression های غیر مبهم و شفاف یک مهارت بسیار مهم است که هر برنامه نویس باید از آن بتواند استفاده کنند. ضمناً در این رابطه می توانید از آموزش متنی کدنویسی تمیز (Clean Coding) در سی شارپ نیز استفاده کنید. دقت کنید که نکات بسیار مهمی در نوشتن این گونه از دستورالعمل ها وجود دارند که باید از آنها مطلع باشید.
ارزیابی کردن یک سلسله دستورات میبایست یک نتیجه دقیق و مشخص و شفاف را حاصل کند. برای مثال عملگرهای تکین و یا اصطلاحاً unary operator ها میبایست با دقت بیشتری مورد استفاده قرار بگیرند. در رابطه با عملگرهای تکین، در آموزش متنی توسعه نرم افزار با سی شارپ صحبت کردیم. لطفاً تصویر زیر را ببینید.

برای اینکه شفافیت کدنویسی افزایش یابد سعی کنید که در یک expression چندین کار مختلف را انجام ندهید. سعی کنید این گونه از دستورات را به قسمت های کوچک تر شکسته و از سطح پیچیدگی آنها بکاهید. ضمناً در رابطه با کاهش پیچیدگی می توانید از آموزش متنی تکنیک های کاهش پیچیدگی سایکلومتیک (Cyclomatic Complexity) در نرم افزار استفاده کنید.
یکی دیگر از مواردی که میتواند به شفافیت دستورالعملها کمک کند ساده بودن آنهاست. دقت کنید که دستورات شما فقط توسط کامپیوترها خوانده نمیشوند. هر نرم افزاری که نوشته میشود در مراحل بعدی که قرار است عملیات نگهداری و maintenance برای آن رخ بدهند، توسط خود شما و یا دیگر برنامه نویسان یک تیم نرم افزاری خوانده خواهد شد. بنابراین بسیار مهم است که کدهای شما طوری نوشته شوند که اگر یک برنامه نویس دیگر تصمیم به خواندن آنها داشت بتواند آنها را درک کند. این موضوع میتواند بر روی قابلیت نگهداری و همچنین ایجاد تغییرات در نیازمندیها و کد، بسیار تاثیرگذار باشد.
نوشتن دستورالعمل های ساده می تواند در چنین شرایطی به کمک ما بیاید. در ادامه برخی از ترفندهای نوشتن دستورالعملهای ساده را خواهید یافت: