не парьтесь, меня пытались тупо наебать

торч хотел просто шоп сделать

Если создать в контроллере коллекцию $users = collect(); а затем пушить в неё данные через $users->push(['id' => 123, 'name' => 'Ivan']); и отправлять в шаблон. В шаблоне данные доступны через $user['id']. Почему не через $user->id?

Потому что так не работает.
https://laravel.com/docs/8.x/collections

потому что ты запушил массив, запуш \stdClass будет как объект

 $users->push((object)['id' => 123, 'name' => 'Ivan']);

 $users->push((object)['id' => 123, 'name' => 'Ivan']);

👍

Подскажите кто шарит, доку для апи как отдельный контейнер выносить или в проекте хранить с апи, swagger (openapi), api blueprint либо еще что-то, автогенерация доки через тесты либо вообще md харкор, кто что использует посоветует? проект большой, апи тоже. на мысли крутится версионность с минорными фиксациями и отображение в доке этих изменений для фронтенд группы

Все существующие автогенерашки апишек дерьмище еще то. Лучше ими воспользоваться один раз  (если проект написан уже без доки) и потом ручками приводить к человеческому виду. Ну или есть кажись одна нормальная но там придется засрать код аннотациями

засрать код аннотациями это точно нет

Не знаю, доку делали в редоке отдельным контейнером, но все ручками

Я делал такую вещь.
Считывал список доступных роутов , разбирал эти роуты, точнее уже сами контроллеры при помощи рефлексии и генерировал доку
Единственный момент, что для таких телодвижений нужны либо хорошие phpDoc комменты,
либо как я делал, везде юзать кастомные классы реквестов и желательно jsonResource для респонсов
тогда можно что-то более-менее человеческое слепить

редок это что? и ручками это md файлами?

JSON.
https://github.com/Redocly/redoc
Это было для публичной доки
Для своих был ридми мдешный

ну это стандартный подход к автогенерации, мне не нравится что по итогу код засран сильно, появляется много лишних телодвижений, это тяжело поддерживать, ну и опять же хотелось бы видеть изменения по сравнению с прошлой минорной версией, типо появилось новое поле, удалено, переименовано

да видел этот продукт, наверное хотели swagger взять но показался деревянным и взяли это? я тоже приглядывался, у вас получается отдельный репо с этим app и там же файлы спецификации?

Ну вот и отлично. Обновил Класс request и увидел новые входные параметры. Добавил к респонсу поле - тоже сгенерировано

мне больше всего понравилось вот это

https://apidocjs.com/

как вариант каждый action маршрута можно закинуть в отдельный файл и в этом же файле через doctype сделать описание, которое потом будет использовано при генерации

но я собирал все в отдельной папке

Да

хм. там есть хорошая функция версионности это круто! но опять же doctype это треш(
с одной стороны хорошо когда есть маршрут метод и описание полное по нему + дока генерится, с другой код увеличивается раздувается превращаясь в помойку. мне кажется поддерживать это становится сложно , нету гибкости чтобы детально все указать, вернее возможность есть, но вместо отдельного файла будет огромный на 300 строк описания что принимает возвращает какие параметры возможные есть. Ну и в вашем кейсе версионности нету, метод правишь, доку правишь, что поменялось добавилось никто не знает, даже намека хотябы на определенный роут. К примеру фронтендищк не имеет доступа к бекенду и не должен, он работает сам по себе ему нужна только дока.

сколько работаете уже с ним и много ли времени отнимает описывает эту спецификацию?