The OpenNET Project / Index page

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



Вариант для распечатки  
Пред. тема | След. тема 
Форум Разговоры, обсуждение новостей
Режим отображения отдельной подветви беседы [ Отслеживать ]

Оглавление

Недоработка в Python-скрипте могла привести к неверным резул..., opennews (??), 13-Окт-19, (0) [смотреть все]

Сообщения [Сортировка по времени | RSS]


365. "Недоработка в Python-скрипте могла привести к неверным резул..."  +/
Сообщение от Аноним (280), 15-Окт-19, 14:21 
Отучили читать документацию, которую за много лет, пользуясь монопольным положением, известная корпорация превратила в набор банальностей. Если не ошибаюсь, последний раз вменяемое руководство по стандартным библиотекам C++ было у Borland (есть в открытом доступе https://archive.org/details/bitsavers_borlandborn3.1LibraryR...). Несмотря на архаичность, это пример, как надо писать документацию. По другим языкам программирования вообще не припомню чего-то подобного.
Ответить | Правка | К родителю #343 | Наверх | Cообщить модератору

376. "Недоработка в Python-скрипте могла привести к неверным резул..."  +/
Сообщение от Аноним (325), 15-Окт-19, 21:27 
> Если не ошибаюсь, последний раз вменяемое руководство по стандартным библиотекам C++ было у Borland

Чем https://gcc.gnu.org/onlinedocs/libstdc++/ хуже?

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

382. "Недоработка в Python-скрипте могла привести к неверным резул..."  +/
Сообщение от Аноним (280), 16-Окт-19, 07:29 
Собственно, подтверждение. В этом всё и дело. Проблема отсутствия структурированной и понятной документации по средствам разработки - вершина айсберга. Основная проблема в том, что, судя по реплике, программистам она и не нужна. Результат - имеем досадные ошибки.
Решение - в тщательном документировании библиотек. Возможно, даже в принятии стандарта. Руководство Borland - первая итерация, какой документация должна быть. Добавил бы в описание каждой функции тестовый набор данных и вывод результатов расчета по данному набору, а также там, где это уместно, математическое обоснование и ссылки на авторитетные источнки.
Ответить | Правка | Наверх | Cообщить модератору

383. "Недоработка в Python-скрипте могла привести к неверным резул..."  +/
Сообщение от Аноним (280), 16-Окт-19, 08:58 
> Чем ... хуже?

Тогда уж https://www.gnu.org/software/libc/manual/pdf/libc.pdf

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

384. "Недоработка в Python-скрипте могла привести к неверным резул..."  +/
Сообщение от Аноним (280), 16-Окт-19, 12:05 
Онлайн документация по функциям должна быть примерно такая:

https://documentation.sas.com/?docsetId=statug&docsetTarget=...

К сожалению, в данной версии недоступна офлайн полностью (только главами). Для предыдущей полный файл PDF содержал более 10000 страниц (с примерами).

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

Архив | Удалить

Рекомендовать для помещения в FAQ | Индекс форумов | Темы | Пред. тема | След. тема




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

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