Несколько лет назад я написал небольшую утилиту для подсчета количества комментариев.
Было очень интересно считать и анализировать комментарии в проектах, над которыми я работал, а впоследствии и в крупных Open Source проектах.
В этой статье представлены результаты, полученные для распространенных проектов с открытым исходным кодом.
Таблица результатов представлена ниже и состоит из следующих столбцов: 1. Название и версия проекта.
2. Количество символов кода.
3. % комментариев от общего объема кода.
4. Соотношение количества строк кода к количеству комментариев.
5. Количество слов todo+fixme. Показатель того, сколько работы осталось в проекте.
| Название и версия | Объем кода | % комментариев | строки кода / Комментарии | задача+исправить меня |
|---|---|---|---|---|
| Апач OpenOffice 3.4.1 | 279 М | 16.3 % | 3.3 | 6557 |
| Мозилла Фаерфокс 14.0.1 | 163М | 25.5 % | 4.5 | 1338 |
| Qt 4.6.4 | 57М | 19.9 % | 7.0 | 395 |
| Блендер 2.63 | 71 М | 10.9 % | 6.0 | 1477 |
| Гимп 2.8.2 | 33М | 7.7 % | 10.6 | 227 |
| ОГРЕ 1.9.0 | 23 М | 23.5 % | 3.5 | 421 |
| Инкскейп 0.48.2 | 19 М | 18.7 % | 5.0 | 1556 |
| Медиаплеер VLC 2.1.0 | 20М | 14.7 % | 6.3 | 1155 |
| PHP 5.4.6 | 45 М | 10.6 % | 6.2 | 277 |
| Медиавики 1.19.1 | 15М | 14.8 % | 5.0 | 546 |
| 7-Zip 920 | 4,2 М | 5.9 % | 25.6 | 0 |
| Злиб 1.2.7 | 694К | 40.9 % | 4.0 | 0 |
В викимедиа были проанализированы все папки кроме языков (спасибо за совет).
Папка Samples была удалена из Ogre. Стоит отметить, что при расчете не учитывался первый комментарий файла, так как скорее всего это авторские права.
Из приведенных выше результатов видно, что в среднем количество комментариев составляет около 15%.
Конечно, OpenOffice выделяется, с 6557 fixme + todos. Из этих комментариев:
- 50 комментариев выглядят так: «TODO: проверить переполнение!»
- Около 10: «TODO TODO TODO: этот поиск O(n) действительно отстой…»
- 68 комментариев типа «избавиться».
- 94 комментария “TODO документируйте меня”
Помимо прочего, сервис отображает статистику по количеству комментариев в них.
Теги: #открытый исходный код #программирование #комментарии #открытый исходный код #программирование
-
Эра Поиска В Devops В Постпандемическом Мире
19 Oct, 24 -
Все Сайты Symbian Foundation Закрываются
19 Oct, 24 -
Зачем Mail.ru Разрабатывает Шпионское По?
19 Oct, 24 -
Как Ит-Специалисту В России Найти Работу?
19 Oct, 24 -
Суд Решил Судьбу Сергея Мавроди
19 Oct, 24
