Size: a a a

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

2020 October 01

EP

Elena Parameshwari in DocOps-сообщество
Maksim Lapshin
Меня пугают слова «спецы ответственные за публикацию» :)

Те там целый отдел что ли чисто деплоем плейн текста занимается?
Это была ситуация с текстами сайта .
Кстати, доку у нас публикуют действительно отдельные люди, ответственные за портал поддержки. И редиректы так же ставят и хранят они :3
Техписы только передают исходники в нужном виде
источник

ML

Maksim Lapshin in DocOps-сообщество
Elena Parameshwari
Это была ситуация с текстами сайта .
Кстати, доку у нас публикуют действительно отдельные люди, ответственные за портал поддержки. И редиректы так же ставят и хранят они :3
Техписы только передают исходники в нужном виде
Как у вас все масштабно :)

Миллионы рублей в год чисто за то, чтобы текст доехал от гита на сайт.


Не, я предпочитаю без таких масштабов. У меня сайтом занимается пара человек. Техпис с тестировщиком делают контент, который потом публикуется конечно роботом.
источник

EP

Elena Parameshwari in DocOps-сообщество
Maksim Lapshin
Как у вас все масштабно :)

Миллионы рублей в год чисто за то, чтобы текст доехал от гита на сайт.


Не, я предпочитаю без таких масштабов. У меня сайтом занимается пара человек. Техпис с тестировщиком делают контент, который потом публикуется конечно роботом.
Есть такое, просто фирма большая, проектов много. Некоторые техписы работают с несколькими группами разработки
источник

ML

Maksim Lapshin in DocOps-сообщество
Я скорее хотел обратить внимание на тот момент, что когда текст коммитят в гит, надо чтобы что-то поняло, что вот эта страничка на самом деле была вот там и теперь у нее новый путь. У нас пути к документации транслитерируются из заголовков и это добавляет чехарды.
источник

EP

Elena Parameshwari in DocOps-сообщество
У меня документация, что хранится в гите - это MD "с описанием встроенного языка программы". Продукт свежий, вышла только бета, файлы хранятся по структуре объектов (задают разработчики, я не влияю). С одной стороны мне легче, с другой стороны, действительно интересно, что будет, если они решат что-то перенести (пока есть пара версий в разработке, но там не было такого). Но и эти MD уходят в контекстную подсказку проги и на сайт в виде HTML с оглавлением. И на сайте редиректы таки снова будет хранить группа поддержки.
Впрочем, например, для другой  доки мы храним идентификаторы разделов (привязаны к заголовками) , что позволяет нам менять структуру разделов , практически не ломая ссылки. Так и живём.
источник
2020 October 02

FM

Fox Mulder in DocOps-сообщество
Кто подскажет, в чем ошибка
источник

FM

Fox Mulder in DocOps-сообщество
"editor.wordWrap": "wordWrapColumn",
   "html.format.wrapLineLength": 80,
   "[asciidoc]": {

       "editor.wordWrap": "on",
       "editor.wordWrap": "wordWrapColumn",
       "editor.wordWrapColumn": "80",
       "editor.quickSuggestions": false
источник

FM

Fox Mulder in DocOps-сообщество
ругается на эти строки
       "editor.wordWrap": "on",
       "editor.wordWrap": "wordWrapColumn",
       "editor.wordWrapColumn": "80",
источник

FM

Fox Mulder in DocOps-сообщество
Мне надо императивно для адока указать значения. То что есть совпадения с global - совпадение
источник

M

Max in DocOps-сообщество
Fox Mulder
ругается на эти строки
       "editor.wordWrap": "on",
       "editor.wordWrap": "wordWrapColumn",
       "editor.wordWrapColumn": "80",
Точно два поля с одинаковым именем?)
источник

FM

Fox Mulder in DocOps-сообщество
Max
Точно два поля с одинаковым именем?)
Да )) я же смотрел.... Нужны вторые очки
источник

J

Julia in DocOps-сообщество
Всем привет! Ребят, подскажите, пожалуйста, как правильно вставлять перекрестные ссылки в markdown? Работаю в  IDEA
источник

J

Julia in DocOps-сообщество
Делаю так, не срабатывает
источник

J

Julia in DocOps-сообщество
источник

VI

Vladimir Izmalkov in DocOps-сообщество
источник

VI

Vladimir Izmalkov in DocOps-сообщество
может так?
источник

J

Julia in DocOps-сообщество
Что-то не нашла здесь про то, как сделать ссылку на раздел этого документа....
источник

L

Lex in DocOps-сообщество
попробуйте <a id=""> вместо <a name="">
источник

J

Julia in DocOps-сообщество
Пробовала, не срабатывает(
источник

a

arvikon in DocOps-сообщество
А чего на русском не ссылаетесь?

[Общие сведения](#общие-сведения)

## Общие сведения
источник