-اصل Good Comments در کلین کد

این اصل چنتا زیر مجموعه داره و کامنت های مفیدی که میتونید بزارید رو گفته تو این پست سعی میکنم به طور خلاصه همشون رو بگم

‏1 - Legal Comments
گاها نیازه که تو اول هر فایل سورس یه سری کامنت در باره ارزش های حقوقی پروژه بزارید مثل این کامنت توی FitNesse:

// Copyright (C) 2003,2004,2005 by Object Mentor, Inc. All rights reserved.
// Released under the terms of the GNU General Public License version 2 or later.

‏2 - Informative Comments
خوبه که بعضی مواقع یه سریع توضیحات دقیق و مختصر رو کامنت کنیم . البته بهتره تا جایی که میشه اسم تابع این اطلاعات رو بهمون بده ولی اگه نشد یه کامنت بزارید مثلا :

// Returns an instance of the Responder being tested.
protected abstract Responder responderInstance()

‏3 - Explanation of Intent
بعضی مواقع خوبه که قصدی که از نوشتن اون تیکه کد رو داشتید کامنت کنید (با این که در اکثر مواقع نیازی به کامنت نیست)

‏4 - Clarification
گاها خوبه که اون تیکه از کدمون که یه مقدار مبهمه به صورت ساده شده یه کامنت در بارش بزاریم مثلاً:

assertTrue(a.compareTo(a) == 0); // a == a
assertTrue(a.compareTo(b) != 0); // a != b

‏5 - Warning of Consequences
ممکنه یه تیکه کدی داشته باشید که ران کردنش یه عواقبی داشته باشه حالا چه کم چه زیاد
بهتر براش تو کامنتا هشدار بنویسید که برنامه نویس های دیگه حواسشون باشه

‏6 - TODO Comments
بعضی وقتا قصد دارید که بعدا یک قسمتی رو بهبود بدید یا اضافه کنید اینطور مواقع میتونید TODO بزارید که معمولاً با TODO // شروع میشه.



منبع:
CleverDevs


#دانستنی
#Clean_Code


@Pairen_Programmers

برنامه بچینید برای تابستان.

#برنامه

@Pairen_Programmers

پیامبر اعظم صلی الله علیه و آله:

من كُنتُ مَولاهُ فَعَلِيٍّ مَولاهُ ، اللّهُمَّ والِ مَن والاهُ ، وعادِ مَن عاداهُ ، وَانصُر مَن نَصَرَهُ ، وَاخذُل مَن خَذَلَهُ ؛ فَإِنَّهُ مِنّي ، وأنَا مِنهُ ، وهُوَ مِنّي بِمَنزِلَةِ هارونَ مِن موسى ، إلّا أنَّهُ لا نَبِيَّ بَعدي؛
هر كه من مولاى اويم، على مولاى اوست خدايا! دوستدار او را دوست بدار و دشمنش را دشمن شمار و يارى دهنده اش را يار باش و واگذارنده اش را واگذار . او از من است و من از اويم و او براى من به منزله ، هارون براى موسى عليه السلام است ، جز اين كه پيامبرى پس از من نيست.
تفسير العيّاشي: ج ١ ص ٣٣٢ ح ١٥٣

عید بزرگ غدیر مبارک باد.

یک روز یک پسر می‌خواست برنامه نویس بشه پس قبل از رفتن به دانشگاه برنامه نویس شد. بعد درس خوند کنکور مهندسی کامپیوتر قبول شد و رفت دانشگاه.
الان دیگه اون برنامه نویس نیست. یک ریاضیدان شده.😁

وضعیت خیلی از بچه ها توی دانشگاه این شکلی است. توی تابستون هم باید بشینه آدم درس بخونه. می‌خواید برنامه نویس بشید خودتون دوره ببینید. دانشگاه علوم پایه رو خوب یاد میده.

#طنز

@Pairen_Programmers

شرمنده اگه پست نمی‌ذارم سرم به درس و کار مشغوله.

♦️ مؤمن نسب، چهره نزدیک به جلیلی:

🎥 اگر یکی دو نفر از VPN فروش‌ها را اعدام کنیم، بقیه دست و پای خود را جمع می‌کنند

جزئیات در👇👇
https://www.entekhab.ir/003LE6
🆔 @Entekhab_ir

با رأی ندادن چنین افرادی قرار هست حاکم بشوند.

وضعیت شبکه‌های اجتماعی در ایران

امروز ۳۰ ژوئن یا ۱۰ تیرماه، روز جهانی شبکه‌های اجتماعی است!

🔴 در ایران تمام شبکه‌های اجتماعی معروف تنها با فیلترشکن و VPN قابل دسترسی هستند.

منبع:
تجارت نیوز



@Pairen_Programmers

ربات Major اومده. احتمالاً شما هم باهاش آشنا شدید و افراد دیگری هم کد زیر مجموعه‌شون رو هم براتون قرار دادن.
درباره‌ی این ربات می‌تونید در لینک زیر مطالعه کنید:
https://dornito.net/major-bot/


لینک من:
https://t.me/major/start?startapp=1795769944

👑Help me to become best of the best in @Major and get some Stars!
15⭐️ invite bonus for you
50⭐️ if you are Premium Major


@Pairen_Programmers

از این به بعد می‌خوام یک تعداد کوییز جنگو بگذارم. اگه کسی میخواد جنگو یاد بگیره بهش بگید.

محلی برای تبادل اطلاعات برنامه نویسان:

https://coderwall.com/


@Pairen_Programmers

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


@Pairen_Programmers

افت فاحش سرعت اینترنت در روز جاری

سرعت اینترنت در ساعات اخیر به طرز شگفت آوری کاهش یافته است، اتفاقی که حتی موجب کندی در اطلاع رسانی «انتخاب» شده است

به نظر می رسد رسیدگی به اوضاع نابسامان اینترنت و فیلترینگ گسترده ای که عیسی زارع پور وزیر ارتباطات فعلی، متهم ردیف اول آن است، باید جزو نخستین اولویت های روزهای ابتدایی روی کار آمدن کابینه دکتر پزشکیان باشد

@Entekhab_ir

حال هوای محرم است. یادی کنیم از نوحه های کوی شیخداد یزد.

#عزاداری
#نوحه


@Pairen_Programmers

😂😂
واقعاً روز به روز opacity بادی رو کم میکنه. 😂

https://github.com/kleampa/not-paid

سلام به همه‌ی اعضای کانال. عزاداریتون قبول.
امشب درباره‌ی نسخه سازی نرم‌افزار می‌خوام صحبت کنم.

خوب اول ببینیم نسخه سازی نرم‌افزار یعنی چی:
What is software versioning?
Software versioning relates to the different versions of software that the software company releases. Each version of a piece of software that is released receives a software version number.


حالا انواع نسخه سازی رو ببینیم:
Whatever method you choose, sticking to one way of numbering is an irrefutable requirement. It enables your company to stay organized and helps users track updates and releases to a specific piece of software.

Some of the most common methods of software version numbering are:

- Semantic numbering – Three-digit numbering technique based on Major.Minor.Patch
- Date-of-release – The software version number is the date of the release. For example, 20.06 (June 2020)
- Unary numbering
- Alphanumeric codes
- Sequential numbering


وقتشه بپردازیم به یکی از رایج ترین شیوه های نسخه سازی یعنی semantic versioning که در بالا به عنوان اولین شیوه‌ی نسخه سازی بهش اشاره شده:
What is semantic versioning?

Semantic versioning is one of the most common methods of numbering software versions. This method uses three numbers for each software version, in Major.Minor.Patch sequence. When a major, minor, or patch update is made, the corresponding number is increased.

- Major version changes are related to incompatible API changes.
- Minor version changes are related to adding new functionality in a backward-compatible manner.
- Patch version changes are related to bug fixes which are also backward compatible.

The version number is increased by one digit, depending on the type of changes made in the new versioning.

For example, software version 1.3.1 means that the software is in its first major version, with three additional functionalities added, and one patch fix implemented. When a developer fixes a bug in that version, the next version release is named version 1.3.2.


شاید شما هم دیده باشید که گاهی اوقات برای نسخه سازی به جای سه شماره از دو شماره استفاده می‌کنند. در اینجا توضیح داده شده:
What is semantic versioning in software development?
Semantic versioning is used widely in software development to number versions of software appropriately and make customer use as easy as possible.

Some products don't need the detailed representation of Major.Minor.Patch numbering, and use a simpler Major.Minor system instead. In contrast, some companies who have frequent releases take the numbering scheme even further. They add a Qualifier at the end of the typical semantic scenario. Therefore, instead of a three-number string, the software version updates would have four numbers.

Semantic versioning offers flexibility within a strict structure. Each organization should identify the correct level of detail they want to publicize in their updates, while remaining informative and useful for the end-users.


بقیه‌ی مقاله رو به خودتون می‌سپارم که بخونید. مطالب بالا هم خلاصه شده بود می‌تونید کل مقاله رو از لینک زیر بخونید.
لینک مقاله:
https://cpl.thalesgroup.com/software-monetization/software-versioning-basics

#دانستنی
#آموزش



@Pairen_Programmers