споти

> Backstage is a Cloud Native Computing Foundation sandbox project

и Spotify, ага

Руки не дошли, и да там вроде плагин для доков есть.

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

Да, это опенсорсный проект Spotify

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

ещё плагин сваггера https://github.com/backstage/backstage/blob/master/plugins/api-docs/README.md

Там документация прикручена через mkdocs, поэтому функциональность будет такая же плюс-минус

В процессе

Пока для сервис конфигов прикрутили только, скоро опробуем плагин для доков. Там нет нативной поддержки кубера пока что, пришлось потрудиться, но она у них в туду

Здорово, жду подробного отзова)

Писал это знакомой, которая хочет перейти в технические писатели. Но это верно для всех, кто в свои ХХ лет хочет поменять профессию и сомневается, что это можно сделать, не имея опыта.

Я в вас верю, вы сможете.

Смотри. У тебя на самом деле не ноль лет опыта, потому что важен и полезен много какой опыт.

Есть общие навыки работы с информацией. Понимать незнакомое, структурировать, выделять связи, объяснять, излагать текстом.

Есть софт-скиллы. Учиться. Принимать обратную связь, в том числе негативную. Давать обратную связь, тоже в том числе негативную. Организовывать свой труд. Расставлять приоритеты. Писать понятные письма. Задавать вопросы — понятые, полные, открытые вопросы, это очень редко кто умеет. Рефлексировать. Отдыхать. Печатать десятью пальцами и вслепую. Договариваться с людьми, передоговариваться. Давать обещания, держать обещания, требовать по обещаниям тебе. Благодарить и принимать благодарность. Ошибаться и идти дальше, извлекать опыт из ошибок, своих и чужих. Давать задачи, брать задачи, руководить и быть руководимой. Сообщать заранее, когда не успеваешь сделать задачу в срок. Обращаться за помощью. Понимать других людей, их эмоции, цели, доступные им знания.

Всё это ты уже насколько-то умеешь. Это твой опыт. Он не нулевой. И всё это настолько же важно в работе, как и знание предметной области и специфических писательских инструментов. Даже больше: предметной области тебя любая компания легко научит. А вот софт-скиллам учить сложно и больно. У тебя они уже развиты и это твоя сильная сторона.

Восхитительный пост, спасибо большое за него ❤️

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

Пост очень приободрил и дал надежду, что со мной все ок😄

Нормально, мы все ничего не умеем ))

Рад, что пост придал вам уверенности

SQL-разработчик это как?
Не холивара ради, а просто интересно

В sql не только запросы, там же функции тоже писать можно

Так что биллинг можно почти на чистом sql построить х)

Биллинг без фронта? 👀

Хм. На чистом SQL можно сделать все (и делали).

И даже фронт )