Size: a a a

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

2019 October 08

MP

Michael Pak in DocOps-сообщество
Я не могу гарантировать того, что безопасник и сетевой архитектор одновременно не захотят отредактировать схему сетевой архитектуры.
источник

MP

Michael Pak in DocOps-сообщество
Angela
доку тоже можно хранить в гите и собирать образы в контейнерах с разграничением доступа, я не девопс, а техпис, но у нас открытая дока и репа, если есть инструменты для шифрования удалённых репозиториев в гите, то почему бы их не применять и к документации
Не очень хорошо, что где то на сервере на диске незашифрованная документация.
источник

A

Angela in DocOps-сообщество
Michael Pak
Не очень хорошо, что где то на сервере на диске незашифрованная документация.
можно раскатывать и локально
источник

MP

Michael Pak in DocOps-сообщество
У нас безопасники хотят на hsm’е хранить доки.
источник

MP

Michael Pak in DocOps-сообщество
Прошу прощения. Случайно.
источник

NK

ID:0 in DocOps-сообщество
code == text

На недавней конференции RubyRussia Андрей "Прогапандист" Баранов из Злых Марсиан проводил параллели между кодом и текстом:
— пирамида тестирования (см. https://t.me/docops/157)
— стайлгайды
— «читай больше X чтобы лучше писать X»
— принцип SOLID

Это был lightning talk, записи нет, есть только слайды: https://speakerdeck.com/progapandist/code-equals-equals-text

Что ещё есть общего? Какие практики можно переносить из кода в текст и обратно? Расскажите в @docsascode.
источник

NK

ID:0 in DocOps-сообщество
Подтверждаю, слова мои. @evilmartians хорошо пишут, иногда даже про документацию :)

https://twitter.com/andrey_sitnik/status/1181555123807494144
источник

AY

Andrei Yemelianov in DocOps-сообщество
какие люди!
источник

VE

Vitaliy Emeliyantsev in DocOps-сообщество
источник

AD

Anton Davydov in DocOps-сообщество
🌊
источник

A

Angela in DocOps-сообщество
вопрос тем, кто работает со связкой sphinx-doc & rst и локализация через po/mo файлы, внезапно выяснилось, что у нас в английской версии поиск происходит по русским страничкам и отображает список найденных страниц на русском, но при переходе на них там нормальные английские странички, может, кто то сталкивался? как исправить поиск в справке по английской версии
источник

A

Angela in DocOps-сообщество
не, очевидно, что проблема в поисковом движке, что то не то настроено
источник

NV

Nick Volynkin in DocOps-сообщество
А что значит «поиск по русским страничкам»? Выдача на русском или запросы понимает только на русском?
источник

A

Angela in DocOps-сообщество
Nick Volynkin
А что значит «поиск по русским страничкам»? Выдача на русском или запросы понимает только на русском?
русские символы в англоязычной версии не находятся, но если искать по английским буквам, то в списке страниц отображаются страницы на русском
источник

A

Angela in DocOps-сообщество
в списке найденных страниц
источник

NV

Nick Volynkin in DocOps-сообщество
Angela
не, очевидно, что проблема в поисковом движке, что то не то настроено
Там при сборке создаётся индекс поиска, это файл .js. Он каждый раз создаётся заново для одного языка. Видимо, в сайт с английской версией попадает файл от русской версии.
источник

A

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

A

Angela in DocOps-сообщество
Nick Volynkin
Там при сборке создаётся индекс поиска, это файл .js. Он каждый раз создаётся заново для одного языка. Видимо, в сайт с английской версией попадает файл от русской версии.
а где этот файл хранится?
источник

NV

Nick Volynkin in DocOps-сообщество
А если посмотреть страничку в инструментах разработчика, и там вкладка Network, и там показаны загруженные файлы JS, вот там какой адрес?
источник

A

Angela in DocOps-сообщество
Nick Volynkin
А если посмотреть страничку в инструментах разработчика, и там вкладка Network, и там показаны загруженные файлы JS, вот там какой адрес?
посмотрю сейчас
источник