Коллеги, а как вы называете часть текста про одно изменение в журнале изменений (changelog'е)? Т.е. заголовок с версией продукта, дата и описание фич и багфиксов.
И аргументы против каждого: record — путаница с русским словом "рекорд" entry — есть entry point, у него совсем другой смысл item — слишком обобщённо, обычно так не называют куски текста
Коллеги, а не подскажете, в asciidoc или в reST есть что-то типа $ref или allOf как в openAPI? Или я совсем не так их способ применения понял?
а что вы пытаетесь сделать? задокать API plain текстом? и вам надо какую-то схему один раз объявить и везде ее вставлять? в reST есть только директива include.