mirror of
https://github.com/bpmbpm/doc.git
synced 2026-04-29 12:00:42 +00:00
19 lines
2.5 KiB
Markdown
19 lines
2.5 KiB
Markdown
## metrics
|
||
### LOC
|
||
- не более 1 000 (1500) строк на модуль с учетом коментариев. Это с учётом всего, ограничение на размер файла.
|
||
Это ограничение связяно с ограничением на Read tool в 25000 токенов, и в целом у нейросетей контекст ограничен, поэтому чем меньше файлы, тем больше шансов что ему потребуется читать из не все. А значит лучше иметь много маленьких файлов. Ну и в целом если он не сможет целиком прочитать файл, то не получится ему сделать согласованные правки в нём.
|
||
|
||
### MR
|
||
- MR Количество строк кода (Lines of Code, LOC) в одном MR (Merge Request) — это метрика, показывающая объем добавленных, измененных или удаленных строк в рамках одного запроса на слияние.
|
||
Это индикатор сложности, качества и времени, необходимого для код-ревью. Небольшие MR (до 200–300 строк) считаются лучшей практикой, так как их легче проверять, они содержат меньше ошибок и конфликтов.
|
||
|
||
показатель означает:
|
||
- Размер изменений: Чем больше строк, тем масштабнее изменения.
|
||
- Сложность код-ревью: Огромные MR (тысячи строк) часто проверяются поверхностно, что повышает риск пропуска багов.
|
||
- Качество и читаемость: Большой объем кода часто свидетельствует о необходимости его декомпозиции (разбиения на более мелкие части).
|
||
- Трудозатраты: Часто используется для предварительной оценки объема работы.
|
||
|
||
Рекомендации по количеству строк:
|
||
- Идеально: 50–100 строк (легко проверить за 15-20 минут).
|
||
- Приемлемо: До 200–300 строк.
|
||
- Плохо: Более 500–1000 строк (требует разбиения на несколько самостоятельных MR).
|