NV
да, тоже хорошее дело. rst не хватало в списке
Про разметку и SSG отдельные опросы стоит сделать
Size: a a a
2019 April 05
2019 April 06
OI
А какова цель опросов?
NV
просто узнать общую карту местности
NV
но, имхо, опросы не дают много информации
NV
куда полезнее интервью: прийти в конкретную компанию и расспросить, как они готовят документацию.
OI
Чтобы собрать карту местности, на интервью далеко не уедешь. Слишком много времени уходит: подготовиться, проинтверьюировать, проанализировать результат. Но в целом, интервью гораздо интереснее для других целей, не связанных с количественной выборкой )
L
Technology radar!
L
Только от docops
I
О, это была бы крутая тема
I
А подскажите, кстати, может кому-то попадался хороший набор идей про git hooks, типа что туда можно добавлять в контексте docops?
OI
Согласна. Интервью о процессах документирования было бы весьма интересно послушать / прочитать
NV
А подскажите, кстати, может кому-то попадался хороший набор идей про git hooks, типа что туда можно добавлять в контексте docops?
Мне кажется, время гитхуков прошло, настало время CI
NV
по крайней мере клиентских, потому что они ж не версионируются, их сложно обновлять
NV
а из серверных мы используем только требования к сообщению коммита, чтобы JIRAKEY указывали
NV
Любые тесты и линтеры — в CI, потому что там они привязаны к пуллреквесту и всем видны
I
Мне кажется, время гитхуков прошло, настало время CI
Нууу и да и нет. Пожалуй соглашусь что когда это стиль на команду, то это должно быть в CI, но если я хочу именно мой локальный какой-то чекер, то я не хочу объяснять CI необходимость добавить проверку obscene словаря в commit message например
I
Или там если я вдруг утром ударился головой и послушав Соболева теперь хочу мой код жёстче линтить чем принято в команде.
Мне просто кроме той или иной вариации линтинга не приходит в голову ничего, хотел посмотреть что ещё народ придумал
Мне просто кроме той или иной вариации линтинга не приходит в голову ничего, хотел посмотреть что ещё народ придумал
NV
Например, в самостоятельных документах на Md я делаю оглавление с помощью
doctoc. И его надо запускать перед коммитом, чтобы он пересобрал оглавление.NV
Вот это, пожалуй, можно было бы повесить на прекоммит-хук.