The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]



"Релиз компилятора Rakudo 2022.02 для языка программирования Raku (бывший Perl 6)"
Версия для распечатки Пред. тема | След. тема
Форум Разговоры, обсуждение новостей
Исходное сообщение [ Отслеживать ]
Присылайте удачные настройки в раздел примеров файлов конфигурации на WIKI.opennet.ru.
. "Релиз компилятора Rakudo 2022.02 для языка программирования ..." +/
Сообщение от Аноним (72), 18-Фев-22, 17:47 
> При изменении порядка аргументов функции нужно апдейтить документацию, потому что смотрят документацию, а не порядок аргументов функции в исходном коде.

Я ж уже писал про это. Во многих реальных проектах документация на функции часто бывает устаревшей или вообще отсутствует. Особенно для внутренних функций модуля, не для API-функций. В идеале, конечно документация всегда должна быть и должна апдейтиться. Но увы, далеко не всегда так бывает.

> смотрят документацию, а не порядок аргументов функции в исходном коде

Это правда для API-функций популярных библиотек. И почти всегда неправда для внутренних функций.

Чтобы далеко за примером не ходить, вот исходник, на который выше ссылку кидали:

https://github.com/uutils/coreutils/blob/main/src/uu/mktemp/...

В файле определено несколько функций, у скольких из них есть документация? Спойлер: ни у одной.

Ответить | Правка | Наверх | Cообщить модератору

Оглавление
Релиз компилятора Rakudo 2022.02 для языка программирования Raku (бывший Perl 6), opennews, 13-Фев-22, 10:34  [смотреть все]
Форумы | Темы | Пред. тема | След. тема



Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру