Size: a a a

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

2019 August 27

SR

Stas Rychkov in DocOps-сообщество
Кто-нибудь зарегистрирован на сайте Apress?

Какая-то реникса с этим Шпрингер Ферлагом. login.apress.com перенаправляет на login.palgrave.com, а тот в свою очередь на login.springer.com

Ни от первого, ни от второго, ни от третьего подтверждения о регистрации не приходят. Гмэйл. В спаме нет. А без подтверждения не войти.
источник

SR

Stas Rychkov in DocOps-сообщество
Занятно видеть такие глюки вёрстки в книге о вёрстке...

As you can see, mixing asterisks and dashes can pretty much f** up your output getting it look as follows. 🙂
источник
2019 August 28

NV

Nick Volynkin in DocOps-сообщество
Stas Rychkov
Занятно видеть такие глюки вёрстки в книге о вёрстке...

As you can see, mixing asterisks and dashes can pretty much f** up your output getting it look as follows. 🙂
)))
источник

NV

Nick Volynkin in DocOps-сообщество
Stas Rychkov
Занятно видеть такие глюки вёрстки в книге о вёрстке...

As you can see, mixing asterisks and dashes can pretty much f** up your output getting it look as follows. 🙂
Это скриншот с сайта или из электронной книги?
источник

SR

Stas Rychkov in DocOps-сообщество
Nick Volynkin
Это скриншот с сайта или из электронной книги?
Книги. Сайта не интересно было бы.
источник

iv

iakov v in DocOps-сообщество
ну так книга, если это epub, это ж почти сайт ;) html и css
источник

SR

Stas Rychkov in DocOps-сообщество
iakov v
ну так книга, если это epub, это ж почти сайт ;) html и css
Поэтому и смешно.
источник

NV

Nick Volynkin in DocOps-сообщество
Kirill Ermolenko
Доброе утро! Прошу помощи у сообщества экспертов. Есть набор микросервисов с синхронным взаимодействием по REST и асинхронным взаимодействием через шину сообщений. Хочется достичь следующего -что бы был некий портал с каталогом микросервисом, что бы при деплое автоматически обновлялась описание мс (что-то похожее на технический дизайн, структура всех сообщений и зависимости от других мс). Нет ли каких-то готовых инструментов для этих целей?
Отличный вопрос, на который у меня нет готового ответа. Из инструментов можно посмотреть на https://netbox.readthedocs.io/en/stable/.
источник

KE

Kirill Ermolenko in DocOps-сообщество
Nick Volynkin
Отличный вопрос, на который у меня нет готового ответа. Из инструментов можно посмотреть на https://netbox.readthedocs.io/en/stable/.
Спасибо я посмотрю. Пока для себя выделил следующие инструменты:
- DocToolChain https://doctoolchain.github.io/docToolchain/#_overview_of_available_tasks По идеологии очень близко, правда надо что-то придумать, что бы к коду прикрутить
- Pivio  http://pivio.io/ подходит для ведения каталога и общей информации по мс
- Swagger для генерации описания REST API
- AsyncAPI https://www.asyncapi.com/ прикольно выглядит для описания асинхронных взаимодействий
- javadoc и asciidoc
Все выше указанное не покрывает все потребности полностью, будем что-то напильником подпиливать
источник

АМ

А М in DocOps-сообщество
Anna Ryutina
я как-то вживую с китайцами на англ. говорила, вот это ад, решили продолжать переписываться
И что, с китайцами удалось выйти из ада? 😝
источник

AR

Anna Ryutina in DocOps-сообщество
А М
И что, с китайцами удалось выйти из ада? 😝
ну да, решили продолжать переписку, т.к. текстом понимать их было проще чем на слух)
источник

NV

Nick Volynkin in DocOps-сообщество
Kirill Ermolenko
Спасибо я посмотрю. Пока для себя выделил следующие инструменты:
- DocToolChain https://doctoolchain.github.io/docToolchain/#_overview_of_available_tasks По идеологии очень близко, правда надо что-то придумать, что бы к коду прикрутить
- Pivio  http://pivio.io/ подходит для ведения каталога и общей информации по мс
- Swagger для генерации описания REST API
- AsyncAPI https://www.asyncapi.com/ прикольно выглядит для описания асинхронных взаимодействий
- javadoc и asciidoc
Все выше указанное не покрывает все потребности полностью, будем что-то напильником подпиливать
Круто, спасибо.

pivio.io в документации: Last updated 2017-09-25 11:55:00 MESZ
как-то это не воодушевляет
источник

KE

Kirill Ermolenko in DocOps-сообщество
Nick Volynkin
Круто, спасибо.

pivio.io в документации: Last updated 2017-09-25 11:55:00 MESZ
как-то это не воодушевляет
Это да, я больше про идеи писал, мы всем этим вдохновились и напишем какой-то свой простой скрипт, который будет делать asciidoc и публиковать в кофнлюенс. Хотя задача кажется типовой, странно, что готовых инструментов нет
источник

NV

Nick Volynkin in DocOps-сообщество
Kirill Ermolenko
Это да, я больше про идеи писал, мы всем этим вдохновились и напишем какой-то свой простой скрипт, который будет делать asciidoc и публиковать в кофнлюенс. Хотя задача кажется типовой, странно, что готовых инструментов нет
Раз уж смотрите на AsciiDoc, посмотрите ещё и на Sphinx & reStructuredText. Я тут как раз вдохновился докладом @Lananovikova про то, как из Sphinx пушить доки в Confluence и тестирую это у себя.
источник

KE

Kirill Ermolenko in DocOps-сообщество
Хорошо, обратим внимание
источник

SR

Stas Rychkov in DocOps-сообщество
Nick Volynkin
Раз уж смотрите на AsciiDoc, посмотрите ещё и на Sphinx & reStructuredText. Я тут как раз вдохновился докладом @Lananovikova про то, как из Sphinx пушить доки в Confluence и тестирую это у себя.
Что за доклад? Интересно!
источник

NV

Nick Volynkin in DocOps-сообщество
@Lananovikova скажи, а когда будут доступны видео с митапа?
источник

L

Lana in DocOps-сообщество
Nick Volynkin
@Lananovikova скажи, а когда будут доступны видео с митапа?
С какого митапа
источник

NV

Nick Volynkin in DocOps-сообщество
последнего WTD Moscow, где ты рассказывала про sphinx-confluence
источник

L

Lana in DocOps-сообщество
Но я же не организатор в этот раз, поэтому не в курсе
источник