ну хз, если сделать примерно в таком же стиле думаю это не будет выглядеть как без возможностей, т.е. ввести сначала все сущности и их взаимодействия без примеров, потом детализировать до примеров
мое видение следующее: более подробно расписанный кор концептс о мотивации именно этих трех юнитов с некоторым послесловием которое могло заинтересовать пользователя в дальнейшем чтении непосредственно API Серега предложил formulae для операторов что выглядит довольно годно при чтении и это дополнит многоуровневый пул примеров от simple до условного advanced
и получится что ты открыл доку и такой "вау, так много всего", а если ты уже работаешь ты открываешь более конкретизированную часть доки и не видишь вот этих всех бесполезных во время работы слов вроде "это как домино"
ну хз, если сделать примерно в таком же стиле думаю это не будет выглядеть как без возможностей, т.е. ввести сначала все сущности и их взаимодействия без примеров, потом детализировать до примеров
Что бы разделить нужно достаточно материала для всех разделов.
Пока дока была минималистическая об этом и думать не стоило. На данном этапе уже нужно задумываться