Size: a a a

DocOps-сообщество

2020 August 25

PP

Pavel Peganov in DocOps-сообщество
Нац Нац
это сообщение в логах же
Ну да. Сообщение о щелчке на предупреждении.
источник

НН

Нац Нац in DocOps-сообщество
А если ты просто перешел на старую версию не зная этого (по внешнему линку, например), то без сообщения о новой версии ты можешь долго тупить
источник

PP

Pavel Peganov in DocOps-сообщество
Вопрос, насколько часто это происходит, какая у продукта модель апгрейда и насколько вероятно, что человеку потребуется именно версия постарше. Вот такое предупреждение, на мой взгляд, уместно, когда у пользователя скорее всего последняя версия; скажем, если автоматическое обновление, или всё в облаке, и т. п.
А иначе нужен только селектор версий на видном месте. Можно дополнительно артикулировать версию сменой дизайна, если на это пошёл и продукт.

Взять вот постгрес, например.
https://www.postgresql.org/docs/10/index.html
Для поддерживаемых версий у них никаких плашек в документации нет. Только для слишком новых (development) и слишком старых (unsupported). Ибо апгрейд СУБД может быть целым приключением, и для пользователей норма подолгу не пересаживаться на более свежую версию, и потому нуждаться в старой документации.
Там просто на видном месте выбор версии.
Но повторюсь, это вопрос продуктовый, а о нём не было ни слова, так что для этого случая такая плашка может и уместна. На правах оффтопика :)
источник

NV

Nick Volynkin in DocOps-сообщество
Семён Факторович
updrafted, типа, взмыл в небо
воо, что-то такое я хотел, спасибо )
источник

NV

Nick Volynkin in DocOps-сообщество
Vadim
step-up
тоже отличный вариант )
источник

NV

Nick Volynkin in DocOps-сообщество
Pavel Peganov
Тогда непонятно, для чего такое злое предупреждение вместо обычного селектора версий 🤔
Аж злое? Ну, у нас старые доки слишком хорошо гуглятся, а хочется направлять людей на более новые.
источник

НН

Нац Нац in DocOps-сообщество
Nick Volynkin
воо, что-то такое я хотел, спасибо )
Такие слова можно выбрать только если ты и только ты будешь смотреть эту аналитику и никто этого не увидит и после тебя (если оно там еще будет)
источник

НН

Нац Нац in DocOps-сообщество
так-то слова эти вообще не звучат как свежие доки
источник

PP

Pavel Peganov in DocOps-сообщество
Nick Volynkin
Аж злое? Ну, у нас старые доки слишком хорошо гуглятся, а хочется направлять людей на более новые.
Ну, жёлтое, с предупреждающим знаком, как warning компилятора, намекающего что у него веские основания подозревать подвох 👀
источник

NV

Nick Volynkin in DocOps-сообщество
Нац Нац
Такие слова можно выбрать только если ты и только ты будешь смотреть эту аналитику и никто этого не увидит и после тебя (если оно там еще будет)
только команда документации, и друг другу мы вполне можем объяснить это
источник

НН

Нац Нац in DocOps-сообщество
А можно назвать прост по нормальному и объяснять не надо будет и новеньким не забыть потом сказать. Так то и разработчики в команде могут договориться называть переменные абы как
источник

НН

Нац Нац in DocOps-сообщество
new-docs-redirect и делов
источник

NV

Nick Volynkin in DocOps-сообщество
Нац Нац
А можно назвать прост по нормальному и объяснять не надо будет и новеньким не забыть потом сказать. Так то и разработчики в команде могут договориться называть переменные абы как
придётся признать, что ты прав
источник

СФ

Семён Факторович... in DocOps-сообщество
Нац Нац
А можно назвать прост по нормальному и объяснять не надо будет и новеньким не забыть потом сказать. Так то и разработчики в команде могут договориться называть переменные абы как
Правильный, но не радующий душу вариант!
источник

ЕД

Егор Доронин... in DocOps-сообщество
Так кто угодно сможет, если сразу по-нормальному назвать
источник
2020 August 26

FM

Fox Mulder in DocOps-сообщество
Привет. А есть в VS инструменты по автоматической отсечке кол-ва символов на строку?
источник

НН

Нац Нац in DocOps-сообщество
Есть, vscode wrap line length
источник

FM

Fox Mulder in DocOps-сообщество
спс ,сейчас попробую
источник

НН

Нац Нац in DocOps-сообщество
Ещё есть плагин, вроде rewrap зовется, но и без него можно
источник

FM

Fox Mulder in DocOps-сообщество
Нац Нац
Есть, vscode wrap line length
Он только для yaml+html
или не обращать на это внимание?
источник