Size: a a a

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

2020 September 29

FM

Fox Mulder in DocOps-сообщество
Это у вас?
источник

VI

Vladimir Izmalkov in DocOps-сообщество
Ты про интерфейс? Нет, честно скомунизжено
источник

FM

Fox Mulder in DocOps-сообщество
Ну я это тоже вон выше запостил )
источник

VI

Vladimir Izmalkov in DocOps-сообщество
Я видел, но версия в обратную сторону интереснее. Не думаю, что это какой-либо реально существующий GUI
источник

СФ

Семён Факторович... in DocOps-сообщество
Fox Mulder
Что думает начальник о моей работе
Картинка многих смыслов, на самом-то деле!

Career goals для техписателя: быть той самой «галочкой», которая позволяет менеджменту сделать документацию одним кликом и не греть голову

Бизнес вообще очень любит, когда с него снимают головную боль. И готов платить за это много денег.
источник

VI

Vladimir Izmalkov in DocOps-сообщество
Семён Факторович
Картинка многих смыслов, на самом-то деле!

Career goals для техписателя: быть той самой «галочкой», которая позволяет менеджменту сделать документацию одним кликом и не греть голову

Бизнес вообще очень любит, когда с него снимают головную боль. И готов платить за это много денег.
Обычно такими словами учат продавать себя на собесах.
источник

FM

Fox Mulder in DocOps-сообщество
Семён, как думаешь, это реальный билд или фейк?
источник

СФ

Семён Факторович... in DocOps-сообщество
Vladimir Izmalkov
Обычно такими словами учат продавать себя на собесах.
но с колокольни бизнеса всё действительно так
источник

СФ

Семён Факторович... in DocOps-сообщество
Fox Mulder
Семён, как думаешь, это реальный билд или фейк?
в смысле, реальная ли это аппа?:)
источник

FM

Fox Mulder in DocOps-сообщество
угу
источник

СФ

Семён Факторович... in DocOps-сообщество
визуальный стиль выдает UI-гайдлайны гугла, подозреваю, что это за 2 минуты сделано в каком-нибудь UI-конструкторе типа Flutter
источник

FM

Fox Mulder in DocOps-сообщество
жалко. А я то обрадовался
источник
2020 October 01

ML

Maksim Lapshin in DocOps-сообщество
Vanderhoöf
Если бы это была единственная проблема ссылок в Markdown, то с этим ещё можно было жить ) Хотя тоже не всегда: расставили вы ссылки на соседние файлы, а потом файлов скопилось так много, что вы решили раскидать их по папкам — все ссылки поломались.

Дальше ещё хуже: расставили ссылки на заголовки в соседних файлах и собрали пдфку  пандоком — всё работает, а потом решили сделать из этого прокта статический сайт, а ссылки перестали работать, потому что якоря заголовков в генераторе статических файлов другие.

Мы в фолианте сделали специальный препроцессор Superlinks, который как раз решает все эти проблемы: ссылаться можно тегом, где пишете просто заголовок, а препроцессор сам его найдёт в файлах проекта и превратит в правильную markdown-ссылку, которая будет работать и при сборке в PDF, и в статический сайт, и в Confluence, и после перетряхивания структуры проекта.

Не знаю, насколько это оверкилл, конечно, ставить фолиант только ради ссылок, но, как говорится, FYI : }
Есть проблема с seo при переименовывании и переносе страниц: гугл то помнит старые названия и если просто выбросить страницу, то будет 404.
источник

EP

Elena Parameshwari in DocOps-сообщество
Так на это случай и настраивают редиректы, но обычно уже на сервере
источник

ML

Maksim Lapshin in DocOps-сообщество
Elena Parameshwari
Так на это случай и настраивают редиректы, но обычно уже на сервере
Настраивать - это лишь самая крохотная часть проблемы. Вопрос в процессе их хранения.

Если это вики с базой данных, там понятно.


Если с обслуживанием вики наелись и перешли на статические страницы, то куда и как и когда складывать редиректы
источник

DB

Dima Boger in DocOps-сообщество
Maksim Lapshin
Настраивать - это лишь самая крохотная часть проблемы. Вопрос в процессе их хранения.

Если это вики с базой данных, там понятно.


Если с обслуживанием вики наелись и перешли на статические страницы, то куда и как и когда складывать редиректы
У нас сборщик статического сайта хранит редиректы и собирает конфиг для nginx вместе со статикой
источник

FM

Fox Mulder in DocOps-сообщество
А кто у вас обслуживает сайт? Техписы всё пилят или есть штатный фронт?
источник

EP

Elena Parameshwari in DocOps-сообщество
Maksim Lapshin
Настраивать - это лишь самая крохотная часть проблемы. Вопрос в процессе их хранения.

Если это вики с базой данных, там понятно.


Если с обслуживанием вики наелись и перешли на статические страницы, то куда и как и когда складывать редиректы
У нас сбором и хранение редиректов занимабтся тех спецы, ответственные за публикацию. Мы им только помогали при переезде и однократно указывали, куда переводить редирект. Они это чуть ли не в экселе собирали. А в чем сейчас хранят, не знаю
источник

DB

Dima Boger in DocOps-сообщество
Fox Mulder
А кто у вас обслуживает сайт? Техписы всё пилят или есть штатный фронт?
А мы тут сами себе штатный фронт
источник

ML

Maksim Lapshin in DocOps-сообщество
Elena Parameshwari
У нас сбором и хранение редиректов занимабтся тех спецы, ответственные за публикацию. Мы им только помогали при переезде и однократно указывали, куда переводить редирект. Они это чуть ли не в экселе собирали. А в чем сейчас хранят, не знаю
Меня пугают слова «спецы ответственные за публикацию» :)

Те там целый отдел что ли чисто деплоем плейн текста занимается?
источник