В рейтинге участвует:

групп:

каналов:

Виртуальный сервер на SSD - недорого!

Аренда выделенных и виртуальных серверов (VDS/VPS), хостинг, аренда IP-адресов, администрирование, круглосуточная поддержка

qwarta.ru подробнее

Резервное копирование с проверкой на вирусы!!!

Удобный сервис создания резервных копий на любой сервер сети интернет. Отслеживайте изменения, проверяйте на вирусы. Надежно защитите свой бизнес!

go.backupland.com

Выбираете сервер? Любая конфигурация на заказ!

Аренда физических серверов любых конфигураций под любые запросы - 1С бухгалтерия, игровые сервера, нагруженные проекты, интернет-магазины!

qwarta.ru подробнее

Size: a a a

Modern::Perl

368 membersпожаловаться на группу
2020 February 01

IB

Ivan Bessarabov in Modern::Perl
Мне нужно сделать доку на http API. Положить ее на гитхаю чтобы другие могли править. Я знаю что это можно сделать с помощью swagger описания. Но может быть уже есть какая-то другая штука, которая лучше чем swagger и которую стоит использовать для этой задачи?
источник
20:58пожаловаться#1

c

crux in Modern::Perl
Ivan Bessarabov
Мне нужно сделать доку на http API. Положить ее на гитхаю чтобы другие могли править. Я знаю что это можно сделать с помощью swagger описания. Но может быть уже есть какая-то другая штука, которая лучше чем swagger и которую стоит использовать для этой задачи?
Сваггер переименовался в OpenAPI, сейчас актуальна третья версия. Если апи влезает в формат, то для openapi сейчас наибольшее количество удобных инструментов на все случаи жизни.
источник
21:44пожаловаться#2

АК

Андрей Кузьмин in Modern::Perl
Ivan Bessarabov
Мне нужно сделать доку на http API. Положить ее на гитхаю чтобы другие могли править. Я знаю что это можно сделать с помощью swagger описания. Но может быть уже есть какая-то другая штука, которая лучше чем swagger и которую стоит использовать для этой задачи?
Опенапи - самое то. Есть ещё raml, но зачем...
источник
21:51пожаловаться#3

AP

Anton Petrusevich in Modern::Perl
да, опенапи щас самое то, чтобы начинать
источник
22:02пожаловаться#4

МИ

Михаил Иванов in Modern::Perl
crux
Сваггер переименовался в OpenAPI, сейчас актуальна третья версия. Если апи влезает в формат, то для openapi сейчас наибольшее количество удобных инструментов на все случаи жизни.
Позанудствовать под вечер:
Cтрого говоря, Cваггер не переименовался, Cваггер разделился — спецификация стала называться ОпенАпи, а инструменты для работы с этой спекой продолжают называться Сваггер.
источник
22:16пожаловаться#5

c

crux in Modern::Perl
Михаил Иванов
Позанудствовать под вечер:
Cтрого говоря, Cваггер не переименовался, Cваггер разделился — спецификация стала называться ОпенАпи, а инструменты для работы с этой спекой продолжают называться Сваггер.
Ок, пусть так. Тогда инструменты вышли из под контроля и их без марки сваггер несколько больше чем под ней )
источник
22:19пожаловаться#6

МИ

Михаил Иванов in Modern::Perl
Это да
источник
22:19пожаловаться#7

МИ

Михаил Иванов in Modern::Perl
Мы активно используем Опенапи (и Сваггер). Я сейчас требую, чтобы все создаваемые сервисы/микросервисы имели спеку Опенапи
источник
22:20пожаловаться#8

IB

Ivan Bessarabov in Modern::Perl
А вот это кто-нибудь щупал вместо swagger? https://github.com/slatedocs/slate
GitHub
slatedocs/slate
Beautiful static documentation for your API. Contribute to slatedocs/slate development by creating an account on GitHub.
источник
22:26пожаловаться#9

МИ

Михаил Иванов in Modern::Perl
оно что, даже не даёт сделать вызов метода прямо со страницы, как Сваггер? как-то неудобно...
источник
22:30пожаловаться#10

SU

Someone Unknown 🇭🇷 in Modern::Perl
Написл и чёт засомневался. Нет ведь ничего плохого в том, чтобы так делать, и не разносить это на две регулярки?

s/(?:^\s+)|(?:\s+$)//g for values %$j;
источник
22:31пожаловаться#11

VG

Vadim Goncharov in Modern::Perl
ну, разносят обычно для читабельности
источник
22:38пожаловаться#12

SU

Someone Unknown 🇭🇷 in Modern::Perl
Пфффф, читабельность, мы тут на перле пишем ващет
источник
22:42пожаловаться#13

VG

Vadim Goncharov in Modern::Perl
и чо?
источник
22:45пожаловаться#14

SU

Someone Unknown 🇭🇷 in Modern::Perl
Читабельность переоценена
источник
22:48пожаловаться#15

VG

Vadim Goncharov in Modern::Perl
вот из-за таких перл и имеет плохую репутацию!
источник
22:49пожаловаться#16

SU

Someone Unknown 🇭🇷 in Modern::Perl
Не, ну я не говорю, что надо писать без пробелов, минифаить и углифаить. Но реально, вот эту вот регулярку разносить на две для читабельности? Этот код не будут поддерживать люди, квалификация которых недостаточна, чтобы прочитать его с первого раза, их к нему просто не подпустят
источник
22:56пожаловаться#17

c

crux in Modern::Perl
Someone Unknown 🇭🇷
Не, ну я не говорю, что надо писать без пробелов, минифаить и углифаить. Но реально, вот эту вот регулярку разносить на две для читабельности? Этот код не будут поддерживать люди, квалификация которых недостаточна, чтобы прочитать его с первого раза, их к нему просто не подпустят
640 килобайт хватит всем ))
источник
22:58пожаловаться#18

DF

Denis F in Modern::Perl
Someone Unknown 🇭🇷
Не, ну я не говорю, что надо писать без пробелов, минифаить и углифаить. Но реально, вот эту вот регулярку разносить на две для читабельности? Этот код не будут поддерживать люди, квалификация которых недостаточна, чтобы прочитать его с первого раза, их к нему просто не подпустят
тут вопрос в том, что даже людям с хорошей квалификацией комфортнее читать читабельный код.
источник
22:59пожаловаться#19

VG

Vadim Goncharov in Modern::Perl
да две эти регулярки в строке одна за другой - идиома уже
источник
22:59пожаловаться#20