Size: a a a

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

2020 October 14

RG

Ramil G in DocOps-сообщество
Maksim Lapshin
Учитывая что тут в целом будет как я скажу, так что условия немного нечестные :)


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

VI

Vladimir Izmalkov in DocOps-сообщество
А есть специалисты c опытом именно по Pandoc генерации PDF из markdown (GFM)?
источник
2020 October 18

ML

Maksim Lapshin in DocOps-сообщество
Коллеги, тут рекламировали фолиант. Спасибо, выглядит прекрасно!
источник

KV

Konstantin Valeev in DocOps-сообщество
Maksim Lapshin
Коллеги, тут рекламировали фолиант. Спасибо, выглядит прекрасно!
источник

ML

Maksim Lapshin in DocOps-сообщество
Ага, спасибо
источник

ML

Maksim Lapshin in DocOps-сообщество
Судя по описанию, тут все то же самое, что я сам пилил для нашего flussonic.com/doc
источник

ML

Maksim Lapshin in DocOps-сообщество
Но только поддерживаемое :)
источник

ML

Maksim Lapshin in DocOps-сообщество
https://foliant-docs.github.io/docs/quickstart/

забавная бага с первой страницы.

Идем к копипасте docker run ..

выделить мышкой команду нельзя, потому что в правом верхнем углу иконка копирования и когда мышка доползает до неё, выделение пропадает.


пользоваться копированием нельзя, потому что копируется весь сниппет, хотя копировать надо только команду.


Вывод: при указании сниппета кода, надо четко разделять: вот это команда, а остальное — результат
источник
2020 October 19

ЕП

Евгений Погребняк... in DocOps-сообщество
Maksim Lapshin
https://foliant-docs.github.io/docs/quickstart/

забавная бага с первой страницы.

Идем к копипасте docker run ..

выделить мышкой команду нельзя, потому что в правом верхнем углу иконка копирования и когда мышка доползает до неё, выделение пропадает.


пользоваться копированием нельзя, потому что копируется весь сниппет, хотя копировать надо только команду.


Вывод: при указании сниппета кода, надо четко разделять: вот это команда, а остальное — результат
В разные сниппеты вставлять код и результат? Внутри же снипета не разделить никак, или можно?
источник

ML

Maksim Lapshin in DocOps-сообщество
Евгений Погребняк
В разные сниппеты вставлять код и результат? Внутри же снипета не разделить никак, или можно?
надо внутри сниппета разделять
источник

ML

Maksim Lapshin in DocOps-сообщество
иначе сейчас оно просто нерабочее
источник

ML

Maksim Lapshin in DocOps-сообщество
https://github.com/slatedocs/slate

> Everything on a single page — Gone are the days when your users had to search through a million pages to find what they wanted.

большая ошибка. Например для нас документация (хорошая) — это то, куда гугл приводит платежеспособных покупателей.

На single page приводить не будет.
источник

СФ

Семён Факторович... in DocOps-сообщество
Maksim Lapshin
https://github.com/slatedocs/slate

> Everything on a single page — Gone are the days when your users had to search through a million pages to find what they wanted.

большая ошибка. Например для нас документация (хорошая) — это то, куда гугл приводит платежеспособных покупателей.

На single page приводить не будет.
А как измеряете конверсию в клиентов?
источник

ML

Maksim Lapshin in DocOps-сообщество
Семён Факторович
А как измеряете конверсию в клиентов?
Так гугл каждого счетчиками и маркерами обвешивает
источник

ML

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

ML

Maksim Lapshin in DocOps-сообщество
Так что могу с цифрами сказать: slate, который делает одну страницу, лишает денег
источник

СФ

Семён Факторович... in DocOps-сообщество
Maksim Lapshin
Дальше у меня ответственный за сайт делает какую-то хитрую операцию, сопоставляет идентификаторы и говорит кто куда ходил
Не, это понятно, но как вы понимаете, что именно документация его сконвертила? Может, он уже на уровне лендинга принял решение, а в документацию залез просто так перед отправкой заявки
источник

RG

Roman Gusev in DocOps-сообщество
Maksim Lapshin
https://github.com/slatedocs/slate

> Everything on a single page — Gone are the days when your users had to search through a million pages to find what they wanted.

большая ошибка. Например для нас документация (хорошая) — это то, куда гугл приводит платежеспособных покупателей.

На single page приводить не будет.
1) SPA не противоречит работе с поисковыми движками
2) Исходя из следующего предожения в абзаце (Slate puts the entire documentation on a single page. We haven't sacrificed linkability, though. As you scroll, your browser's hash will update to the nearest header, so linking to a particular point in the documentation is still natural and easy.), у меня вообще создалось впечатление, что это не SPA, а просто одна большая страница, что тоже не противоречит поисковым движкам
источник

RG

Roman Gusev in DocOps-сообщество
другое дело — непонятно, как это все будет работать, когда документации будет много
источник

ML

Maksim Lapshin in DocOps-сообщество
Roman Gusev
1) SPA не противоречит работе с поисковыми движками
2) Исходя из следующего предожения в абзаце (Slate puts the entire documentation on a single page. We haven't sacrificed linkability, though. As you scroll, your browser's hash will update to the nearest header, so linking to a particular point in the documentation is still natural and easy.), у меня вообще создалось впечатление, что это не SPA, а просто одна большая страница, что тоже не противоречит поисковым движкам
Мы видим падение качества индексирования если вместо тошнотворного транслита в урлах нормальные пути. Так что противоречит :(
источник