- Tytuł:
-
Komentarze w kodach wybranych programów
Comments in the codes of selected programs - Autorzy:
-
Skhut, Sviatoslav
Iholkina, Kateryna - Powiązania:
- https://bibliotekanauki.pl/articles/131989.pdf
- Data publikacji:
- 2018
- Wydawca:
- Wrocławska Wyższa Szkoła Informatyki Stosowanej Horyzont
- Tematy:
-
source code
software
software engineering
documentation
software management
code comments
kod źródłowy
oprogramowanie
inżynieria oprogramowania
dokumentacja
zarządzanie oprogramowaniem
komentarze kodu - Opis:
- Writing comments is as important as writing code. The main purpose of using comments is to improve readability of our code but frequently thoughtless comment writing decrease understandability of source code. Comments must be concise and precise simultaneously. Also, when our code is changed, comments for this code must be changed too. While using comments in our code we must realize that if expressiveness of our programming language allows us to express clearly what we want in code, there is no need to write comments at all. And if we decide to use comments, they must be extremely accurate and understandable, because another person must understand, what we do and most importantly, why we do it. Frequently comments can be replaced with good clear names of variables, functions or classes. Also, we can replace our comments with assertions. Comments should clarify and explain our intentions. Copyrights and an authorship can be implemented using comments too. But our IDE can do these things automatically.
- Źródło:
-
Biuletyn Naukowy Wrocławskiej Wyższej Szkoły Informatyki Stosowanej. Informatyka; 2018, 8, 1; 24-28
2082-9892 - Pojawia się w:
- Biuletyn Naukowy Wrocławskiej Wyższej Szkoły Informatyki Stosowanej. Informatyka
- Dostawca treści:
- Biblioteka Nauki
Artykuł