Size: a a a

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

2021 September 15

А

Александр Мокрушин... in DocOps-сообщество
тот же Foliant посмотрите https://github.com/foliant-docs/foliant

есть отдельный чат: https://t.me/foliantdocs
источник

VB

Vitaly Belyakov in DocOps-сообщество
Спасибо! 🙏 Сегодня же попробую
источник

А

Александр Мокрушин... in DocOps-сообщество
у него тоже Pandoc под капотом, не знаю, будут ли игнорироваться html-таблицы
источник

А

Александр Мокрушин... in DocOps-сообщество
можно уточнить в чате
источник

J

Jonny Cuba in DocOps-сообщество
Привет, нет, не подойдет, дока сырая, часто меняется, строки слетать будут
источник

А

Александр Мокрушин... in DocOps-сообщество
Всем привет!
Кто-нибудь настраивал правила Vale для документации на русском?
Поделитесь, пожалуйста, что своим опытом. Какие ситуации проверяли линтером?
источник

AY

Andrei Yemelianov in DocOps-сообщество
а там русский полноценно поддерживается разве?
источник

А

Александр Мокрушин... in DocOps-сообщество
не уверен
источник

VB

Vitaly Belyakov in DocOps-сообщество
я настраивал, да. Та ещё морока) особенно для тех, кто в регулярках ни в зуб ногой (как я)
настраивал как для поиска сленговых слов и выражений, так и для более сложных ситуаций (пропущенное форматирование элементов интерфейса, инфинитив вместо повелительного наклонения)
источник

VB

Vitaly Belyakov in DocOps-сообщество
неполноценно, в этом главная проблема. Но определёнными махинациями заставить можно
источник

AY

Andrei Yemelianov in DocOps-сообщество
а подробнее про махинации можно? (здесь или в личку)
источник

А

Александр Мокрушин... in DocOps-сообщество
лучше здесь, конечно)
источник

AY

Andrei Yemelianov in DocOps-сообщество
мне нужно проверять на наличие вполне конкретных выражений
и не вычищать их оперативно
источник

VB

Vitaly Belyakov in DocOps-сообщество
можно, но надо спросить разрешение, могу ли я делиться своей работой, или это корпоративная тайна) если в общих словах - гуглил примеры регулярок для своей ситуации (например, чтобы искал слово «конфиг», но игнорировал «конфигурационный», «конфигурирование» и т.д.), и пытался их применять поочерёдно или совместно, и таким вот эмпирическим тыканьем добивался результата
источник

VB

Vitaly Belyakov in DocOps-сообщество
самое паскудное, что в одной конкретной ситуации это работает, а в другой абсолютно аналогичной почему-то нет)
источник

AY

Andrei Yemelianov in DocOps-сообщество
@vbelyakoff , я думаю, это неплохая тема для доклада на профильной конференции или для статьи на Хабре
источник

AY

Andrei Yemelianov in DocOps-сообщество
а исходная документация в каком формате?
источник

А

Александр Мокрушин... in DocOps-сообщество
а может есть другой линтер, который точно поддерживает русский?
источник

AY

Andrei Yemelianov in DocOps-сообщество
я не знаю  - не встречал
источник

AY

Andrei Yemelianov in DocOps-сообщество
опечатки я ловил утилитой aspell
источник