Size: a a a

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

2019 September 03

DE

Daniel Ershov in DocOps-сообщество
только в папке еще куча других подпапок было
источник
2019 September 04

NV

Nick Volynkin in DocOps-сообщество
Коллеги, а как вы называете часть текста про одно изменение в журнале изменений (changelog'е)? Т.е. заголовок с версией продукта, дата и описание фич и багфиксов.
источник

СФ

Семён Факторович in DocOps-сообщество
очень хочется сказать «blog entry»:)
источник

NV

Nick Volynkin in DocOps-сообщество
или blog post, ага
источник

NV

Nick Volynkin in DocOps-сообщество
мои варианты: changelog record, changelog entry, changelog item
источник

DE

Daniel Ershov in DocOps-сообщество
changelog entry выглядит достойно
источник

СФ

Семён Факторович in DocOps-сообщество
Daniel Ershov
changelog entry выглядит достойно
+1
источник

NV

Nick Volynkin in DocOps-сообщество
И аргументы против каждого:
record — путаница с русским словом "рекорд"
entry — есть entry point, у него совсем другой смысл
item — слишком обобщённо, обычно так не называют куски текста
источник

СФ

Семён Факторович in DocOps-сообщество
я бы про entry поспорил
источник

СФ

Семён Факторович in DocOps-сообщество
у entry есть очень сильная коннотация «элемент», она вряд ли перебьется словосочетаниями, где это слово используется как прилагательное или наречие
источник

NV

Nick Volynkin in DocOps-сообщество
Ок, спасибо )
источник

FM

Fox Mulder in DocOps-сообщество
может кто знает: что такое модуль six
источник

НН

Нац Нац in DocOps-сообщество
Fox Mulder
может кто знает: что такое модуль six
контекст?
источник

НН

Нац Нац in DocOps-сообщество
источник

KE

Kirill Ermolenko in DocOps-сообщество
Коллеги, а не подскажете, в asciidoc или в reST есть что-то типа $ref или allOf как в openAPI? Или я совсем не так их способ применения понял?
источник

НН

Нац Нац in DocOps-сообщество
видимо такой себе 2to3 и 3to2 в одном флаконе
источник

НН

Нац Нац in DocOps-сообщество
ага, больная для питона тема
источник

RG

Ramil G in DocOps-сообщество
Kirill Ermolenko
Коллеги, а не подскажете, в asciidoc или в reST есть что-то типа $ref или allOf как в openAPI? Или я совсем не так их способ применения понял?
а вам это для чего?  по сабжу подсказать не могу, просто любопытно.
источник

SY

Sofia Yemelianova in DocOps-сообщество
Kirill Ermolenko
Коллеги, а не подскажете, в asciidoc или в reST есть что-то типа $ref или allOf как в openAPI? Или я совсем не так их способ применения понял?
а что вы пытаетесь сделать? задокать API plain текстом? и вам надо какую-то схему один раз объявить и везде ее вставлять? в reST есть только директива include.
источник

NV

Nick Volynkin in DocOps-сообщество
в Sphinx есть  sphinx-apidoc, если уж на то пошло
источник