Привет, я надеялся это будет маленький пост из картинок, но вдруг меня понесло 🤦🏻‍♂️ Так что дальше идёт поток сознания о том, как мы не просто разрабатываем, а доносим до людей, что у нас происходит и какие фичи или багфикс происходят в том или ином пакете «Платформы»

Конечно, как я…

В предыдущем посте я уже рассказал, какую задачу должен решать хороший CLI инструмент, а в этой, наконец покажу, как писать максимально информативный и понятный CLI без боли.

Приступим

OpenSource 💁🏻‍♂️, даже README есть :]

Но! Читать его не нужно, как я уже говорил, «Платформа» это минимум документации, максимум автоматики/команд, поэтому просто…

Честно, не знаю проектов, которым не нужны были бы какие-либо shell-скрипты/утилиты, но это никак не мешает их отсутствию в реальности.

Именно по этой причине разработка «Платформы» началась именно с @mail-core/cli , пакета, который не только должен упростить написание любых shell-скриптов, а дать целую инфраструктуру и инструментарий для создания богатого Command…

Когда-то давно я написал npmy или npm link на стероидах, чтобы решить проблему честной разработки монорепы с полным npm-циклом публикации, т.е. без симлинков, как в Lerna. Но это статья не об этом (почти) :]

Эта статья только про проблемы и как я их для себя решил, сам инструмент использовать не…

Как уже написано в первой части, «Платформа» должна охватывает полный цикл разработки от инфраструктуры, до архитектуры, но чтобы начать, нужно сделать для этого… платформу 💁🏻‍♂️

Чтобы написать «Платформу», вам нужна платформа

Так что же выбрать для основы? Готовые решения? Написать самому? Ничего из вышеперечисленного!

«Основой» должны стать ваши коллеги!

Да, именно так, вы делаете это не…

Что такое «Платформа»? Библиотека? Может Фреймворк? Возможно Инфраструктура и/или Архитектура? 🤔 Конечно, ничто из перечисленного, но всё сразу в одном «флаконе» 💁🏻‍♀️

«Платформа» — это среда, обеспечивающая работу ваших проектов всем необходимым, от инфраструктуры до архитектуры.

Уверен, у всех вас/нас она есть в том или ином виде, либо готовом, либо…

Или PerfKeeper v1.8.0. Если кто не в курсе, то совсем скоро у нас появиться нормальное API для мониторинга memory, поэтому, чтобы не терять время, запилил поддержку это замечательной фичи на ещё более замечательном

npm i --save @perf-tools/keeper@latest

Всё как обычно работает «из коробки»

Или самодокументируемый Go-код.

👋🏻 Ремарка: Это пост больше для моих коллег из mail.ru, но и остальным должно быть интересно взглянуть как у… точнее у меня теперь устроен процесс документирования кода

Не надо мне писать про swagger или GraphQL, последний кстати очень близок к решению проблем нашего APIDOC, который сейчас отвечает…

Два года назад, я психанул и написал набор инструментов для работы вbash. В нём я собрал основные функции, которые постоянно приходилось гуглить и конечно emoji 😷

Фичи

  • Автоустановка — вы просто подключаете небольшой снипет и тулза ставится сама
  • Автообновление—🤯, да, при выходе новой версии, ~/.bashkit/ сам обновится ;]
  • Документация— всё покрыто…

Да, это наконец случилось, я наконец доделал (на самом деле нет, но у меня работает) свой лучший инструмент, который мечтал сделать уже как минимум 5, а может и 6 лет.

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

Предыстория

В свой жизни мне приходилось заниматься интернационализацией…

Lebedev Konstantin

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store