Size: a a a

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

2019 June 14

I

Igor in DocOps-сообщество
Да, я видел эти первые ссылки в гугле.
Плагин это не то, ишью конечно печаль, потому и вопрос может там есть какая-то другая интеграция или ещё что
источник

I

Igor in DocOps-сообщество
Типа тыкать не удобно в общем, и проще из консоли
источник

I

Igor in DocOps-сообщество
Но тогда опять находишь себя в какой-то момент внутри вима, который ты запустил внутри эмулятора терминала внутри vscode который вроде бы как бы не для этого запущен был
источник

НН

Нац Нац in DocOps-сообщество
:D Там слача б-гу уже запилили поддержку линуксового терминала из винды в вскод, должно быть sladko и быстро
источник

L

Lana in DocOps-сообщество
Angela
возникла такая проблема со sphinx-doc: после билда и деплоя на сайт по поисковым запросам выдаются странички, исключённые из билда и из файла-книжки (index.rst), как отключить поиск по неактивным страницам, но находящимся в билде? например, страницу временно исключили из вёрстки, её нет в навигации, но поиск всё равно на неё ведёт, причём она открывается
Лучше может вообще ее не собирать, если ее нет в иерархии, добавить в игнор в conf py
источник

A

Angela in DocOps-сообщество
Lana
Лучше может вообще ее не собирать, если ее нет в иерархии, добавить в игнор в conf py
а как в игнор добавлять в конфиг?
источник

L

Lana in DocOps-сообщество
Angela
а как в игнор добавлять в конфиг?
exclude_patterns
источник

NV

Nick Volynkin in DocOps-сообщество
Angela
возникла такая проблема со sphinx-doc: после билда и деплоя на сайт по поисковым запросам выдаются странички, исключённые из билда и из файла-книжки (index.rst), как отключить поиск по неактивным страницам, но находящимся в билде? например, страницу временно исключили из вёрстки, её нет в навигации, но поиск всё равно на неё ведёт, причём она открывается
может, это баг инкрементальной сборки? Sphinx не удаляет из build/html страничку с прошлой сборки.
источник

A

Angela in DocOps-сообщество
Nick Volynkin
может, это баг инкрементальной сборки? Sphinx не удаляет из build/html страничку с прошлой сборки.
вот тоже такое же ощущение, интересно, он не чистит билд-папку перед сборкой чтоли
источник

A

Angela in DocOps-сообщество
Lana
exclude_patterns
спасибо, попробуем
источник

L

Lana in DocOps-сообщество
Nick Volynkin
может, это баг инкрементальной сборки? Sphinx не удаляет из build/html страничку с прошлой сборки.
И да точно на билде ее лучше принудительно очищать, у нас скрипт делает rm -rf
источник
2019 June 15

ЕД

Егор Доронин in DocOps-сообщество
Надо полностью зачищать предыдущую версию, это на любом генераторе хорошая практика.
Насчёт пушить прямо из VSCode - терминал есть, и он работает. Но проще параллельно держать открытой консоль, из нее получится сделать только то, что в явном виде хотел.
источник

ЕД

Егор Доронин in DocOps-сообщество
Кстати, амазоновский стек с CodePipeline очень хорошо справляется со сборкой документов, надо только один раз настроить.
источник

ЕД

Егор Доронин in DocOps-сообщество
Весь билд и деплой сводится к одному коммиту в ветку мастер
источник

ЕД

Егор Доронин in DocOps-сообщество
А дальше облачная магия и CloudFormation
источник

L

Lex in DocOps-сообщество
В vscode можно пушить и коммитить мышкой, с этим там всё хорошо :)
источник
2019 June 16

NV

Nick Volynkin in DocOps-сообщество
Егор Доронин
Надо полностью зачищать предыдущую версию, это на любом генераторе хорошая практика.
Насчёт пушить прямо из VSCode - терминал есть, и он работает. Но проще параллельно держать открытой консоль, из нее получится сделать только то, что в явном виде хотел.
В целом согласен, но есть исключения. У нас полная пересборка документации Jekyll'ом длится 20+ минут, поэтому используем инкрементальную сборку.
источник

NV

Nick Volynkin in DocOps-сообщество
Про гит: я пользуюсь терминалом и всем рекомендую именно терминал. Это неспроста. Когда-то я поотвечал на кучу вопросов по git на stackoverflow. Немалая часть проблем вызывана тем, что люди пользуются клиентами для гита. Клиенты вносят две проблемы:
1. Часто в интерфейсе клиента используются собственные термины для разных операций. Вот представьте, что есть кнопка Synchronize. Что она делает: забирает изменения с сервера, отправляет их на сервер, всё это, что-то иное?
2. Клиенты прячут конкретные сообщения об ошибках за размытыми формулировками, которые не гуглятся. Например, мы нажимаем кнопку Synchronize и клиент пишет нам «ошибка соединения». Что это означает? Ошибка в пути, на сервере нет нашего публичного ключа, мы пушим в защищённую ветку, мы отключили  интернет, сервер ответил 502?
источник

ЕД

Егор Доронин in DocOps-сообщество
+100500. В клиентах есть ненужные абстракции, плюс всегда настроить клиент всегда сложнее, чем консоль.
источник

EN

Ekaterina Noskova in DocOps-сообщество
Nick Volynkin
Про гит: я пользуюсь терминалом и всем рекомендую именно терминал. Это неспроста. Когда-то я поотвечал на кучу вопросов по git на stackoverflow. Немалая часть проблем вызывана тем, что люди пользуются клиентами для гита. Клиенты вносят две проблемы:
1. Часто в интерфейсе клиента используются собственные термины для разных операций. Вот представьте, что есть кнопка Synchronize. Что она делает: забирает изменения с сервера, отправляет их на сервер, всё это, что-то иное?
2. Клиенты прячут конкретные сообщения об ошибках за размытыми формулировками, которые не гуглятся. Например, мы нажимаем кнопку Synchronize и клиент пишет нам «ошибка соединения». Что это означает? Ошибка в пути, на сервере нет нашего публичного ключа, мы пушим в защищённую ветку, мы отключили  интернет, сервер ответил 502?
я пользуюсь консолью пополам с github desktop и нормально
источник