Size: a a a

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

2019 August 21

AR

Anna Ryutina in DocOps-сообщество
не правда, для меня papfers это непонятное слово.
источник

AR

Anna Ryutina in DocOps-сообщество
откудаж мне знать, что это оказывается конфиг?)
источник

VS

Vadim Smelyanskiy in DocOps-сообщество
Это не слово, это связанные системные утилиты
источник

AR

Anna Ryutina in DocOps-сообщество
Vadim Smelyanskiy
Это не слово, это связанные системные утилиты
ну вот я первый раз открыла этот док, откуда мне это знать?))
источник

AR

Anna Ryutina in DocOps-сообщество
не спорю) я вообще пример "тупого юзверя" -)) мне придется залезть в гугл прежде чем понять это
источник

A

Angela in DocOps-сообщество
может, кто-то подскажет, можно ли в RST подложить перекрёстную ссылку под картинку? так, чтобы при нажатии на эту картинку происходило не её открытие, а переадресация на указанный ресурс
источник

L

Lex in DocOps-сообщество
Серьёзные щщи != казенщина
источник

L

Lex in DocOps-сообщество
Igor
Вот тут тоже в документации хороший пример встретил.
Пример плохой доки. А что делает эта команда? Точно все поймут? Лучше бы написали пресным языком, что "добавьте такой-то параметр и будет то-то и то-то"
источник

L

Lex in DocOps-сообщество
Серьёзный текст без хиханек-хаханек и оценочных прилагательных не всегда будет уродским казенным текстом.
источник

L

Lex in DocOps-сообщество
Слава котикам, я с госзаказчиками не работаю 😺
источник

I

Igor in DocOps-сообщество
Lex
Пример плохой доки. А что делает эта команда? Точно все поймут? Лучше бы написали пресным языком, что "добавьте такой-то параметр и будет то-то и то-то"
Нууу.. Тут явно ЦА очерчена и там до этого разбираются все флаги, то есть я бы сказал что нормально, все параметры известны, а единственный описан в следующем же абзаце
источник

I

Igor in DocOps-сообщество
Lex
Серьёзный текст без хиханек-хаханек и оценочных прилагательных не всегда будет уродским казенным текстом.
А можете дать пример текста, который вам кажется подходящим под такое определение?
источник

L

Lex in DocOps-сообщество
Igor
А можете дать пример текста, который вам кажется подходящим под такое определение?
Дока по Mongo DB
источник

L

Lex in DocOps-сообщество
Простой понятный текст без эмоций
источник

L

Lex in DocOps-сообщество
Она клёвая, мне нравится
источник

NV

Nick Volynkin in DocOps-сообщество
Angela
может, кто-то подскажет, можно ли в RST подложить перекрёстную ссылку под картинку? так, чтобы при нажатии на эту картинку происходило не её открытие, а переадресация на указанный ресурс
Продублирую для этого чата:
.. image:: picture.png
  :target: example.com

http://docutils.sourceforge.net/docs/ref/rst/directives.html#image
источник

A

Angela in DocOps-сообщество
Nick Volynkin
Продублирую для этого чата:
.. image:: picture.png
  :target: example.com

http://docutils.sourceforge.net/docs/ref/rst/directives.html#image
спасибо)) вдруг ещё кому то поможет
источник

NV

Nick Volynkin in DocOps-сообщество
я тут делаю небольшое исследование и сам впервые прочитал многие разделы документации reST и Sphinx. Вот, например, про инклюды много нового узнал.
источник

A

Angela in DocOps-сообщество
надо бы тоже углубиться в технические детали, да времени всё нет
источник

OI

Olga Ilchukova in DocOps-сообщество
Nick Volynkin
я тут делаю небольшое исследование и сам впервые прочитал многие разделы документации reST и Sphinx. Вот, например, про инклюды много нового узнал.
Например?
источник