mastodon.world is one of the many independent Mastodon servers you can use to participate in the fediverse.
Generic Mastodon server for anyone to use.

Server stats:

8.1K
active users

#openapi

5 posts5 participants0 posts today

How to generate HTML docs from an OpenAPI 3 spec file? I'm currently using widdershins + middleman to render slate, which feels a bit outdated and cumbersome. The best modern tool I found so far is redocly. Its in-page search doesn't seem to work though?

#openapi #api (somewhat #ruby related)

OpenAPI во фронтенде или магия автоматизации

Мы все чаще сталкиваемся с парадоксом: с одной стороны, растут требования к скорости вывода продукта на рынок, с другой — увеличивается сложность приложений. При этом, разработчики тратят большое количество времени на рутинные задачи, такие как интеграция с API и написание boilerplate-кода. Именно здесь на помощь приходит автоматизация рутинных задач во фронтенде на основе OpenAPI-спецификаций и она может очень сильно упростить нам, фронтендерам, жизнь!

habr.com/ru/companies/axenix/a

ХабрOpenAPI во фронтенде или магия автоматизацииПривет! Меня зовут Ларионова Екатерина, я фронтенд-разработчик в компании AXENIX . В современной разработке программного обеспечения согласованность между документацией, дизайном API и его реализацией...

Frontend и OpenAPI: генерация клиента, мокирование API и данных с помощью MSW

Генерация кода по спецификации OpenAPI и мокирование запросов - эффективный способ автоматизировать процессы разработки и решить некоторые специфические задачи. В статье описано применение различных инструментов, которые могут быть использованы при генерации и мокировании.

habr.com/ru/companies/nauka/ar

ХабрFrontend и OpenAPI: генерация клиента, мокирование API и данных с помощью MSWВ нашей компании в процессе разработки frontend‑приложений мы иногда сталкиваемся с одной из следующих ситуаций (или с обеими сразу): Когда мы имеем достаточно объемную и...
#openapi#msw#mocks

Is there any best practice for how to document authorization on specific endpoints within #openapi documentation? f.e. if an endpoint requires a specific user role. it does not seem to be covered within the spec itself, that only seems to be dealing with authentication.

Introducing: BinkyLabs.OpenApi.Overlay a new library to parse and apply OpenAPI overlays in #dotnet !!! 🎉🎉🎉🎉

github.com/BinkyLabs/openapi-o

Over the last week, a good friend of mine Matthieu COSTABELLO and I have been hacking away to produce this new library. It's modeled after Microsoft.OpenAPI, parses, serializes and applies overlays to documents.

With overlays, you can maintain patches to #OpenAPI description, extremely useful when your team doesn't "own" the document but needs to maintain only a few changes. Using this library, a host of OpenAPI tools built in #dotnet will be able to support this specification and new feature!

Stay tuned for more projects from BinkyLabs!

Системное мышление: когда разработчик становится архитектором

Что отличает архитектора от кодера? Не должность, не титул, не стаж. Ответ - в мышлении. В том, кто видит систему целиком, предвидит цепные последствия и способен сказать "нет" быстрому решению, которое отравит код через полгода. Эта статья - честное и местами болезненное размышление о системном мышлении, архитектуре и точке невозврата, после которой разработчик уже не может смотреть на код по-старому.

habr.com/ru/articles/925354/

ХабрСистемное мышление: когда разработчик становится архитектором🧩TL;DR Разработчик решает задачи, архитектор - строит будущее.Если ты ещё думаешь, что архитектура начинается с UML-диаграмм - ты опоздал. Она начинается в момент, когда каждый if, костыль и...

“The goal from starting out is to be able to create an API documentation suite from scratch. The minimal viable document, or the minimum the document must contain before it’s released, includes having all the calls covered, a description, even if only one sentence at this point, for every field and call, section overviews, call examples, and examples of each field. I suggest also creating a Postman collection file for each API suite. A Postman collection file is a complete set of all the requests and that each request may be run by clicking it; it’s a convenience to clients.

Being able to create that document indicates the writer’s proficiency in the mechanics of API documentation. There is a sense of accomplishment when achieving this and comfort with this process. And rightly so. They have the privilege now of calling themselves API documentation writers.”

robertdelwood.medium.com/start

Medium · Starting API Documentation Writers: Obstacles To Watch Out ForBy Robert Delwood