Aleksey
пока всё что ты говоришь похоже на теоретизирование по теме. или такой стиль изложения мыслей.
Aleksey
фиг знает.
Aleksey
"а давайте всё сделаем праивльно". а всё что в праивльно не попадает - оно не праивльно и делать не нужно.
Леннарт Zh 🕊
Имя, ты работал в коллективах админов от 40 человек да ?
В декабре я устроился в коллектив
где было 25 менеджеров и я - один админ.
потом пришёл второй, потом появились, 20 админов в регионах
сейчас больше 100 человек,
из них 70-с-чем-то - админы
я работал в коллективе,
где непрерывно набирают админов
процесс очень бурного роста
и on-boarding-а
Aleksey
так какого же лешего ты за два дня не можешь объяснить как работать в такой среде ?
Леннарт Zh 🕊
так какого же лешего ты за два дня не можешь объяснить как работать в такой среде ?
Кому объяснить?
Я семидесяти объяснил,
дело скорее всего в тебе.
Aleksey
ок. дело в 71-ом.
Леннарт Zh 🕊
https://www.openproject.org/help/user-guides/system-settings/repositories-settings/
Aleksey
или поскольку предыдущие 70 были коллеги им было стремно "показаться". а мне пофиг. и я честно говорю. я не понимаю что у тя за канитель с докой получилось.
Леннарт Zh 🕊
https://netbeans.org/kb/73/ide/kenai-issuetracking.html
Леннарт Zh 🕊
или поскольку предыдущие 70 были коллеги им было стремно "показаться". а мне пофиг. и я честно говорю. я не понимаю что у тя за канитель с докой получилось.
Дока не нужна! Это сейчас основной подход.
Если нужна дока - ты что-то делаешь неправильно.
Все системы документирования построены на этом.
Пишите хороший код, который работает
и устойчив к изменениям, т.е. легко параметризируем,
содержит множество проверок (тестов) и богато комментирован.
Aleksey
Дока не нужна! Это сейчас основной подход.
Если нужна дока - ты что-то делаешь неправильно.
Все системы документирования построены на этом.
Пишите хороший код, который работает
и устойчив к изменениям, т.е. легко параметризируем,
содержит множество проверок (тестов) и богато комментирован.
ладно. ок. дока не нужна. самодокументируемые подходы, внятное именование переменных и сущностей.
всюду git. всюду коммиты. всюду тесты. я понял. спасибо.
Леннарт Zh 🕊
https://en.wikipedia.org/wiki/Requirements_traceability
Леннарт Zh 🕊
https://confluence.atlassian.com/bitbucket/resolve-issues-automatically-when-users-push-code-221451126.html
Леннарт Zh 🕊
http://jedelman.com/home/generating-web-docs-for-ansible-modules/
Aleksey
Леннарт Zh 🕊
Ты мне напоминаешь верующего в Путина
и закончившуюся 15..16 декабря 2014 г. "стабильность" пенсионера.
Спасибо что погуглили, конечно,
но кто вам сказал, что в этом вашем гугле правду пишут?!
Интернет - вообще разработка 0мереканской военщины!
И ЦРУ!
Леннарт Zh 🕊
Aleksey
Леннарт Zh 🕊
ладно. ок. дока не нужна. самодокументируемые подходы, внятное именование переменных и сущностей.
всюду git. всюду коммиты. всюду тесты. я понял. спасибо.
Это не "самодокументируемые подходы"
это реальный способ написания документации
ПРОМЫШЛЕННЫЙ
Просто он пока применим к языкам ПРОГРАММИРОВАНИЯ,
а вот к языкам управления конфигурацией его
предстоит применить тебе.
Форкни вот этого буржуина:
http://jedelman.com/home/generating-web-docs-for-ansible-modules/
Aleksey
реальный. кто же спорит.
Леннарт Zh 🕊
Aleksey
просто не то что мне надо.
Aleksey
твой подход в виде "дока не нужна" я понял.
Aleksey
просто в моем случае она нужна. и я ищу удобный способ ее структурирования.
Anonymous
Ого
Anonymous
Вы понаписали
Леннарт Zh 🕊
Просто у меня секретарша однажды
вместо "режима редактирования"
или как он там называется в Word-е
Прислала патч к документу *.docx
Aleksey
Просто у меня секретарша однажды
вместо "режима редактирования"
или как он там называется в Word-е
Прислала патч к документу *.docx
испортил девочку. а ей еще жить и жить.
Леннарт Zh 🕊
Вы понаписали
Это был бесплатный чятинар "Документирование не нужно"
а вы всё пропустили.
Anonymous
Дока для ансибла странно
Anonymous
Ансибл сам как дока
Anonymous
В смысле плейбук
Леннарт Zh 🕊
Дока для ансибла странно
Но есть, как оказалось.
Просто нашему визави "всё не торт!"
Anonymous
Ну может ему надо для джунов глупых чот
Aleksey
дока нужна не для ансибла. а для того что бы знать какой плейбук запускать.
Anonymous
А, тут согласен
Anonymous
Вот тут насрал ролей нимношк
Anonymous
И вот уже сам вспоминаю куда какая
Aleksey
я и написал выше. важно иметь возможность передать сложное действие в управление к людям которые могут выполнять простые действия.
Anonymous
Но вопросы отпадают после чтения
Anonymous
Плюс есть мета
Леннарт Zh 🕊
Anonymous
Вообще у меня мечта
Anonymous
Скрестить ансибла с гитлаб сиай
Anonymous
И там через билды выбирать роли, параметры
Anonymous
И угорать
Aleksey
поцедура переключения трафика с одного набора серверов на другой - сложный процес. автоматизирован.
нужна дока в стиле
* когда стработал триггер А нужно пойти в систему Б и нажать кнопку С
Anonymous
Гитбла
Aleksey
когда произошло что то не то. вот кому сдавать.
Anonymous
Ну на плейбук цепляешь билд и ок
Anonymous
А если привязать мои говноскрипты для провижина квм вмок
Anonymous
То будет полный опсец
Леннарт Zh 🕊
поцедура переключения трафика с одного набора серверов на другой - сложный процес. автоматизирован.
нужна дока в стиле
* когда стработал триггер А нужно пойти в систему Б и нажать кнопку С
Это целых два действия
человек рано или поздно напишет ошибку.
Anonymous
Ну норм
Anonymous
Почему бы и нет
Леннарт Zh 🕊
не для джунов. для полностью внешней организации.
history+script(asciinema)
Но это бред.
Это как индусскому кол-центру
отдать на аутсорс обязанность
рассказывать "почему вы должны выбрать
именно нашу контору для оказания услуг"
Документация не поможет
будут или мычать
или нести ахинею
или повисев 20 минут на трубке
"лид" соскочет
Anonymous
Да не. Дока может быть в аутсорс
Anonymous
Или просто приемнику
Anonymous
Да дофига куда
Anonymous
Скажем так - если есть возможность и время задокументировать
Леннарт Zh 🕊
поцедура переключения трафика с одного набора серверов на другой - сложный процес. автоматизирован.
нужна дока в стиле
* когда стработал триггер А нужно пойти в систему Б и нажать кнопку С
Я просто не расслышал триггер
я просто перепутал серваки
я просто промахнулся мимо кнопки.
Да, я читал документацию,
она хорошая,
в следующий раз буду стараться лучше.
Anonymous
То почему нет
Леннарт Zh 🕊
Скажем так - если есть возможность и время задокументировать
Я вот задокументировал
и меня уволили.
Леннарт Zh 🕊
А пока не задокументировал - не увольняли.
Держали, терпели, платили,
даже в должности и зарплате повышали.
Anonymous
Anonymous
Твори бардак чтобы никто не разобрался
Anonymous
На самом деле так работать и надо
Anonymous
Все починил наладил и задокументировал
Anonymous
Сьебывай
Anonymous
Че сидеть?
Aleksey
твои не бардак а твори такую систему в которой порог входа должен постостоянно расти.
Леннарт Zh 🕊
На самом деле так работать и надо
Там щас остался один такой деятель.
Владеющий загадочным баш-кунфу.
Aleksey
что бы взять специалиста с рынка было дороже чем поднять этому зп на 5%