Светлый Emacs

это наверное интересно, самому выдумывать факты, а потом спорить со своими утверждениями %)

складывается ощущение, либо вы троллите, либо забыли таблетки принять.

Странно, в SICP пишут, что для изучения программирования нужно не только писать, но и читать много кода. Именно программ, а не учебников по программированию. Врут наверное)

они все верно пишут. нужно много читать кода. но как это коррелирует с вашим тезисом, что комментарии писать не надо и код сам должен себя объяснять?

Да-да, в minix нет ни код стайла, ни линтер не использован, ога))

это коррелирует

вы гумманитарий?))

это имеет причинно-следственную связь с вашим постом, которы откроется, если нажать релевантную ссылку в контролах моего поста.

нахожу бессмысленным продолжение этой «дискуссии». соболезную вашим коллегам и тем, кто по долгу службы вынужден разгребать ваш «самодокументированный код»

https://github.com/scala/scala/blob/2.13.x/src/library/scala/Array.scala

попробуйте найти комментарии именно к коду, docstring не в счет. заметили, уровень сложности соответсвует именно вашему hello world?

это я к чему. а вот к чему. комментаторы пытаюся сделать из портянок конфетку, 31337 управляют сложностью.

OPC-DA

А какой смысл обертку говна менять?

А ну да, ну да, дробить на очень мелкие функции, используемые один раз и рассказывать что это не комментарии.

странный пример с набором функций из одной или нескольких строк. документация кода, это например вот это https://github.com/golang/go/blob/master/src/slices/slices.go#L132

почему там столько комментариев? потому как «code cannot explain the rationale behind why the program is being written or why it is implemented in such a way»

набором функций из одной или нескольких строк.

просто автор читал SICP.. и.. написал стандартную библиотеку Scala! А вы нет))

Поясни - а то нихрена не понял что ты хотел сказать.

почему там столько комментариев?

там документация к стандартной библиотеке. и.. портянка, которая не влезает в экран, но исписана комментариями.

https://swagger.io/

Я не знаю твоих задач, но эта штука сама описывает. Сам пользую с ASP.NET. Python слишком медленный, а Django разочаровал. Это, правда, 2016-17 года были…

кстати, как в C сделать инспекцию кода на неиспользуемое значение возврата функции, чтоб как в Go? для нуба вроде меня, который всю жизнь использовал исключения?

самодокументируемым может быть только код уровня hello world

Цитатник_Луговского.txt facepalm

https://en.wikipedia.org/wiki/Self-documenting_code

Претензии к самодокументированию не в том, что код «сложен и непонятен», а в том, что не отвечает на вопрос про purpose и why in such a way.

Я теперь иди читай про literate programming и зачем его изобрели.

как в C сделать инспекцию кода на неиспользуемое значение возврата функции

Флаг компилятора включи. Clang и GCC сейчас умеют это.

иди читай про literate programming

какой код с literate кроме Кнута можно прочитать?

Clang и GCC сейчас умеют это

там для функций с атрибутом, а мне для всех

иди читай про literate programming

какой код с literate кроме Кнута можно прочитать?

На хачкелле такого кода до жопы. Там есть нативная поддержка в компиляторе и интеграция с латехом. Ищи на гитхабе файлы с расширением .lhs

там для функций с атрибутом, а мне для всех

Тогда c++lint. Там такое было.

хачкелле такого кода до жопы

я еще талмуд не прочитал

Шрифт — IBM Plex Mono.

Одобряю. Хотя в таком разрешении любой шрифт будет неплохо выглядеть, ibm plex даже в 96dpi хорош.

Наискосок пока прочитал, но насколько понял делает тоже самое что и fastapi в плане документации.

Вот конкретно пример из функции, которая с криншота -

https://monitor.scurra.space/api/docs#/default/get_balance_api_get_balance_get

Доки для API у меня минимальные, и API не всё покрывает пока (т.к. всего 1 юзер пока, который API использует).

На самом деле это оказался обман, там Dejavu Sans Mono =)

Тогда не одобряю!

Какой смысл под древний OPC-DA переписывать скаду?

Потому что поддерживать скаду уже невозможно. Там, мля, даже отрисовка мнемосхем прибита гвоздями к 1024*768.

DEPовский протокол systrack`а закрыт(какая-то 9-битная хрень). Програмистов ихние «фификтивные совы» разогнали. Существует только один OPC-сервер - windecont, который под винду-10ку работает через одно место (отваливается его автозапуск с запуском нужного вирт. контролера). Есть OPC-UA под «железный деконт», но его пока не тыкали.

А на японском?

Почему не zomg_ponies?

Название стрёмное. Не все – фанаты мультфильмов про пони.

Лучшая светлая тема это Flatlor поверх waltz. А пони для онимешникофф 😐

Вчера обнаружил, у самого Таненбаума ядро Minix написано literate. А вот userspace - самодокументируемый код. Почему так написано ядро? Для удобства изучения)

Настройка такая – все что вылазит за 80(?) символов подсвечиватся

Способ не подскажете (а лучше просто показать сам конфиг емакса)?

для собственных нужд и для тех кому такое нужно

legaltech?

Там хоть вертикальной записи нету?

Комментарии на русском языке…

комменты на русском это зашквар

каменты на нерусском, вот это зашквар.

Вавилоняне с духовностью в жопе, вот это зашквар.

Только если с кодом идут субтитры.

иконки дропнуть, сам радактор заменить на vim+nerdtree и будет збс)))))

IT сфера — это англоязычная вотчина (исторически так сложилось). Поэтому комменты должны быть на английском. Иначе вы обрекаете свой проект на забвение по ряду причин:
— умные прогеры за него не возьмутся
— сообщество опенсорс за него не возьмется

Проект так и останется мелкой поделкой на русскоязычную аудиторию и низкой покупательской способностью.

Поэтому комменты должны быть на английском.

кому, простите, они должны?

IT сфера — это англоязычная вотчина

у нас тут как, ИТ ресурс? мы на каком языке сейчас пишем?

Вот писал бы ты на английском тебя бы сам Линус читал. А так, лишь ноунеймы из глубинки.

тебя бы сам Линус читал.

я лично верю в человечество и даже в линуксоидов. даже Линус вполне способен асилить русский язык.

зря ты на него наговариваешь.

Комментарии должны отвечать на вопрос «зачем?», а код должен быть написать так, чтобы код отвечал на вопрос «как?». Всё остальное write only.

Отлично звучит в теории, но касается именно комментирования деталей реализации. Публичный же интерфейс надо описывать именно с точки зрения «что делает», и описывать даже если это довольно очевидно. И у автора именно публичный интерфейс, эти docstrings напрямую прорастут в OpenAPI-описание.

раз уж тут взялись за код: переприсваивание ресурса бд в каждом методе имеет какой-то смысл? оно ведь по ссылке все равно

Это ужасно, конечно. Во-первых, однокласники запрезирают, во вторых, вдруг в проект внутрикорпоративного портала или системы управления складом вдруг набегут стопицот иностранных программистов, ничего не поймут и расстроятся? Ужас же, стыдоба (это так старики кринж называют).

Проект так и останется мелкой поделкой на русскоязычную аудиторию и низкой покупательской способностью.

Покупатель он же такой,первым делом интересуется на каком языке там комменты внутре.

Линус вполне способен асилить русский язык

А еще еврейский, корякский, и даже клингонский.

Способ не подскажете (а лучше просто показать сам конфиг емакса)?

Я этим не пользуюсь, но если бы пользовался то:

https://emacsredux.com/blog/2013/05/31/highlight-lines-that-exceed-a-certain-length-limit/

https://www.emacswiki.org/emacs/HighlightLongLines