Телеграмм чат группы docsascode страница 481

Size: a a a

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

544 membersпожаловаться на группу

2019 October 20

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

Лол

источник

22:00пожаловаться #1

2019 October 21

Nick Volynkin in DocOps-сообщество

Sergey Bronnikov

https://twitter.com/patio11/status/1184277080898338816 ""People should just read their man pages."

If you like your man pages you can keep your man pages, but there are a few million people operating systems professionally who ask their questions to Google because Google has a reputation for providing actual answers quickly.". Если пользователи ищут ответы не напрямую в документации, а в Гугле это ведь не значит, что документация плохая. Но иногда бывает, что документация действительно не полная и не покрывает какие-то сценарии, которые описаны в блогах или stackoverflow. Улучшаете ли вы документацию когда видите популярные вопросы для вашего ПО на stackoverflow или например вопрос который в google suggest появляется?

Twitter

Patrick McKenzie

"People should just read their man pages." If you like your man pages you can keep your man pages, but there are a few million people operating systems professionally who ask their questions to Google because Google has a reputation for providing actual answers quickly.

Если я правильно помню, наш саппорт мониторит StackOverflow и ServerFault, отвечает там на вопросы.

А ещё мы стараемся чтобы доки были в Гугле первой строкой ))

источник

05:52пожаловаться #2

Andrei Yemelianov in DocOps-сообщество

Всем привет!

источник

12:27пожаловаться #3

Andrei Yemelianov in DocOps-сообщество

есть два вопроса

источник

12:27пожаловаться #4

Andrei Yemelianov in DocOps-сообщество

вопрос первый:

у меня настроена сборка документации в формате HTML c помощью Pandoc
мэйкфайл выглядит так:

html:

        pandoc "$(INPUTDIR)"/*.md \
        -o "$(OUTPUTDIR)/out.html" \
        --standalone \
        --template="$(STYLEDIR)/template.html" \
        --include-in-header="$(STYLEDIR)/style.css" \
        --highlight zenburn \
        --toc \

источник

12:31пожаловаться #5

Andrei Yemelianov in DocOps-сообщество

на выходе получается html-файл, в котором в самом начале идут стили CSS, а потом всё остальное

источник

12:32пожаловаться #6

Andrei Yemelianov in DocOps-сообщество

вопрос такой

источник

12:33пожаловаться #7

Andrei Yemelianov in DocOps-сообщество

а можно ли как-то в pandoc прописать, чтобы CSS был не в начале, а в КОНЦЕ документа?

источник

12:33пожаловаться #8

iakov v in DocOps-сообщество

AFAIK, у HTML нет отдельного footer, но есть раздел <HEAD>, куда ссылки на стили и попадают.

источник

12:35пожаловаться #9

Andrei Yemelianov in DocOps-сообщество

iakov v

AFAIK, у HTML нет отдельного footer, но есть раздел <HEAD>, куда ссылки на стили и попадают.

это я знаю

источник

12:37пожаловаться #10

Andrei Yemelianov in DocOps-сообщество

и второй вопрос

источник

12:39пожаловаться #11

Andrei Yemelianov in DocOps-сообщество

кто-нибудь писал TeX-шаблон для pdf-документов, содержащих специфические для письменностей на основе кириллицы символы (в моём случае речь идёт об абхазском языке)?

источник

12:41пожаловаться #12

iakov v in DocOps-сообщество

Andrei Yemelianov

это я знаю

А какую задачу вы таким образом пытаетесь решить, помещая стиль в конец документа?

источник

12:41пожаловаться #13

Andrei Yemelianov in DocOps-сообщество

iakov v

А какую задачу вы таким образом пытаетесь решить, помещая стиль в конец документа?

1) можно на "ты"; 2) попросил коллега, который потом накладывает на этот документ всякие красивости

источник

12:42пожаловаться #14

iakov v in DocOps-сообщество

я просто не могу придумать, для чего бы могло понадобиться иметь стиль именно в конце документа. но у pandoc есть опция -A (include after body), может быть она поможет

источник

12:46пожаловаться #15

Andrei Yemelianov in DocOps-сообщество

iakov v

Спасибо, Яков!

источник

12:47пожаловаться #16

Anna P in DocOps-сообщество

Всем привет, есть довольно обширный вопрос - если масштабировать DocOps команду с одного человека до полноценной команды, какие роли и компетенции вы видите? В идеальном мире (т.е. берем максимальное полезное количество человек), где есть автоматизация, локализация и несколько продуктов, которые надо поддерживать?
Приветствуются любые мысли, статьи, личный опыт и все-все.

источник

23:27пожаловаться #17

2019 October 22

Антон in DocOps-сообщество

Коллеги, добрый день! Может кто-нибудь поделиться наработками по преобразаванию из DITA в pdf по госту?

источник

07:29пожаловаться #18

Fox Mulder in DocOps-сообщество

я делал, правда из docbook_a. Забейте, если у вас нет athena процессора для рендера. Apache-Fop коряво с таблицами работает.

источник

08:24пожаловаться #19

2019 October 24