Безнадёга
Другие наши проекты: https://t.me/+1s1ZEg7EeQ5mNDVi
Другие наши проекты: https://t.me/+1s1ZEg7EeQ5mNDVi
Если у вас есть еще на эту тему — присылайте в комменты
"Мастер кода: ЧПУ"
В мире, где технологии становятся неотъемлемой частью нашей жизни, существует группа избранных - тех, кто обладает уникальными навыками и знаниями в области программирования. Они - мастера кода, чьи таланты выходят за рамки обычного понимания программирования.
Этот рассказ повествует о приключениях одного такого мастера кода, чьи способности простираются далеко за границы обыденного. Он сталкивается с вызовами, которые проверяют его силу, ум и храбрость, в то время как он стремится к пониманию самой сути мира, который он помогает создавать.
От встречи с загадочным мастером кода до разгадывания сложных тайн скрытых в темных уголках мира ЧПУ, этот рассказ погружает вас в захватывающий мир технологий и программирования. Путешествуйте вместе с главным героем по его пути к мастерству, где каждый шаг приводит к новому открытию и каждое испытание - к росту и совершенствованию.
Поговаривают, что в некоторых компаниях сотрудники уже не понимают, что происходит в коде проекта. Де-факто для коллективной работы картография проекта — необходимость, нежели привилегия...
Составление пояснений и комментариев к обширным ИИ-системам — трудоемкая задача, но под небольшие опен-сорс/продакшн проекты есть решение.
AutoDocstring — инструмент, который автоматически создает документацию к коду на основе структуры и комментариев. Экономия времени, согласованность стиля, адекватная читаемость и повышенную точность документации — плюсы этого тула. Выделил нужный блок кода, прожал ctrl+shift+2 — готово.
Просматривать строки документации можно во вкладках, выбирать типы форматов строк, выводить типы параметров через подсказки типов pep484, значения и имена переменных. Внутри поддержка args, kwargs, декораторов, ошибок и типов параметров.
Теперь в утилиту можно добавлять "кастомные" документации. Чтобы использовать собственный шаблон, создайте файл .mustache и укажите путь к нему с помощью конфигурации customTemplatePath.
Сгенерированная документация содержит структурированные описания функций, методов и классов. Однако AutoDocstring не всегда правильно интерпретирует комментарии в коде или не учитывает особенности некоторых языков программирования.
А еще записи могут не соответствовать стандартам или требованиям проекта.
Поэтому редактировать и редактировать. Но для создания костяка описаний инструмент — идеально. AutoDocstring сократит время, затрачиваемое на написание документации, на 30-50%. А еще неплохо так снизит число ошибок в тексте.
Скачать можно с официального сайта Microsoft.