Size: a a a

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

2020 October 19

ML

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

RG

Roman Gusev in DocOps-сообщество
Maksim Lapshin
Мы видим падение качества индексирования если вместо тошнотворного транслита в урлах нормальные пути. Так что противоречит :(
Не очень понял идею, тошнотворный транслит лучше нормальных путей?

(В любом случае, spa сам по себе, как и slate, который, похоже, не spa, а просто single page, не диктуют формат путей, который вы будете использовать)

Disclaimer: я slate никогда в жизни не видели и не использовал, просто заметил знакомые слова про спа и не смог не ворваться
источник

ML

Maksim Lapshin in DocOps-сообщество
Roman Gusev
Не очень понял идею, тошнотворный транслит лучше нормальных путей?

(В любом случае, spa сам по себе, как и slate, который, похоже, не spa, а просто single page, не диктуют формат путей, который вы будете использовать)

Disclaimer: я slate никогда в жизни не видели и не использовал, просто заметил знакомые слова про спа и не смог не ворваться
Да. Тошнотворный транслит лучше, чем play/protocols/dash
источник

ML

Maksim Lapshin in DocOps-сообщество
Roman Gusev
Не очень понял идею, тошнотворный транслит лучше нормальных путей?

(В любом случае, spa сам по себе, как и slate, который, похоже, не spa, а просто single page, не диктуют формат путей, который вы будете использовать)

Disclaimer: я slate никогда в жизни не видели и не использовал, просто заметил знакомые слова про спа и не смог не ворваться
А single page вообще без урлов.
источник

DB

Dima Boger 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, а просто одна большая страница, что тоже не противоречит поисковым движкам
А это не SPA, это просто одна страница. Гугл плохо их индексирует
источник

DB

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

DB

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

DB

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

iv

iakov v in DocOps-сообщество
проиндексировал-то гугл хорошо, в том смысле, что страница попала в индекс и выдаётся по запросам, просто одна и та же на множество запросов. имхо, дело не в том, как проиндексировано, а в принципе в подходе
источник

DB

Dima Boger in DocOps-сообщество
iakov v
проиндексировал-то гугл хорошо, в том смысле, что страница попала в индекс и выдаётся по запросам, просто одна и та же на множество запросов. имхо, дело не в том, как проиндексировано, а в принципе в подходе
Неа, она плохо проиндексирована — одни и те же метатеги у всех "страниц"

У API clients вообще дичь — гугл не смог собрать нормальное описание)
источник

DB

Dima Boger in DocOps-сообщество
Гугл такое не любит и при наличии минимальной конкуренции по ключевикам будет уводить страницу вниз
источник

DB

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

DB

Dima Boger in DocOps-сообщество
Телеграм вообще метатеги для превью собрать не может 🌚
источник

DB

Dima Boger in DocOps-сообщество
В защиту скажу, что не всей документации нужно хорошо индексироваться
источник

ML

Maksim Lapshin in DocOps-сообщество
Dima Boger
В защиту скажу, что не всей документации нужно хорошо индексироваться
«не всех детей надо прививать, только тех, кого вы любите»  =)

Да, индескировать надо только ту документацию, которую хочется показывать клиентам
источник
2020 October 20

VI

Vladimir Izmalkov in DocOps-сообщество
А бывает такое преобразование markdown + .po => localized.md ?
Такое можно при помощи pandoc сделать?
источник

DL

Dmytro Lispyvnyi '(🌲... in DocOps-сообщество
Vladimir Izmalkov
А бывает такое преобразование markdown + .po => localized.md ?
Такое можно при помощи pandoc сделать?
нагуглилось отакое https://bitbucket.org/tagoh/gettext-markdown
источник

FM

Fox Mulder in DocOps-сообщество
po файлы разве не только сфинкс жрёт ?
источник

DB

Dima Boger in DocOps-сообщество
Fox Mulder
po файлы разве не только сфинкс жрёт ?
Нет, .po это gettext, распространенный тридцатилетный формат
источник

iv

iakov v in DocOps-сообщество
в gettext, кстати, огромное количество "граблей" и "подводных камней" локализации решено. странно, что это всё ещё не самая популярная штука для локализации
источник