knuckleswtf / scribe

Generate API documentation for humans from your Laravel codebase.✍
https://scribe.knuckles.wtf/laravel/
MIT License
1.58k stars 280 forks source link

only name & example supported in the header #842

Open mikeah2011 opened 1 month ago

mikeah2011 commented 1 month ago

Scribe version

4.35.0

scribe.php

    'type' => 'static',
    'theme' => 'elements',

Your question

I found that there are no extensions GenericParam in the header, only name and example are supported.

I speculate that it may be due to certain reasons or scenarios, such as encountering unpredictable errors when generating OpenAPI Specifications and Postman Collections. But I think we can try debugging it.

Of course, I am just discussing this topic. If you need me to contribute to this part of the design, I can take some time to organize my PR. Currently, I am trying to run it on my project and have not found any abnormal scenarios. If you are interested, please refer to:

I found that there are still quite a few areas that need to be debugged, and it should be adapted to various themes.

Docs

shalvah commented 1 month ago

Feel free to debug and send in a PR!