আমি সঠিকভাবে নথিভুক্ত কোডের প্রবক্তা, এবং আমি এটির সম্ভাব্য উতরাই সম্পর্কে ভালভাবে জানি । এটি এই প্রশ্নের ক্ষেত্রের বাইরে।
আমি ভিজুয়াল স্টুডিওতে ইন্টেলিজেন্সকে আমার কতটা পছন্দ তা বিবেচনা করে প্রতিটি পাবলিক সদস্যের জন্য এক্সএমএল মন্তব্য যুক্ত করার নিয়মটি অনুসরণ করতে চাই।
অপ্রয়োজনীয়তার একটি ফর্ম রয়েছে, যা আমার মতো অত্যধিক কমেন্টারও বিরক্ত করে। উদাহরণ হিসাবে তালিকাভুক্ত করুন ।
/// <summary>
/// Determines whether the List<T> contains elements
/// that match the conditions defined by the specified predicate.
/// </summary>
/// <returns>
/// true if the List<T> contains one or more elements that match the
/// conditions defined by the specified predicate; otherwise, false.
/// </returns>
public bool Exists( Predicate<T> match )
{
...
}
Summaryএবং returnsমূলত একই জিনিস বলছে। আমি প্রায়শই ডকুমেন্টেশন পুরোপুরি returnsবাদ দিয়ে দৃষ্টিকোণ থেকে সারাংশ লেখার শেষ করি returns।
লিস্টে এমন উপাদান রয়েছে যা নির্দিষ্ট প্রিকিকেট দ্বারা নির্ধারিত শর্তগুলির সাথে মেলে, অন্যথায় মিথ্যা হলে সত্যটি প্রত্যাবর্তন করে।
অতিরিক্তভাবে, রিটার্নের ডকুমেন্টেশনগুলি ইন্টেলিজেন্সে প্রদর্শিত হয় না, তাই আমি বরং যে কোনও তাত্ক্ষণিক প্রাসঙ্গিক তথ্য লিখি summary।
- কেন কখনও আপনার
returnsথেকে আলাদা করে নথির প্রয়োজন হবেsummary? - মাইক্রোসফ্ট কেন এই স্ট্যান্ডার্ড গ্রহণ করেছে সে সম্পর্কে কোনও তথ্য?