You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
I attempted to add the @urlParam comment for an ID field where the primary key is a column other than ID (called 'Symbol'), and it did not override the generated documentation contrary to what is explained in Scribe's documentation here: https://scribe.knuckles.wtf/laravel/documenting/url-parameters
@urlParam symbol string required The symbol ticker to get data for (case-sensitive) Example: AAPL
But instead of displaying my custom description in the generated documentation, it lists 'symbol_Symbol' as the parameter and has no description. I can override the description by changing the comment to @urlParam symbol_Symbol string required The symbol ticker to get data for (case-sensitive) Example: AAPL to match what is being generated, but I want the parameter to be correctly labelled symbol rather than symbol_Symbol.
Other than that this is a great tool, thank you developers!
Hmmm, that's weird. The parameter name is being wrongly inferred for some reason. What does it show as the endpoint URL in the docs?
Imagine if i have route like this
/api/v1/userRole/{roleType}/existBy and in controller i add
Scribe version
4.37.1
PHP version
8.3
Framework
Laravel
Framework version
11.15.0
Scribe config
What happened?
I attempted to add the
@urlParam
comment for an ID field where the primary key is a column other than ID (called 'Symbol'), and it did not override the generated documentation contrary to what is explained in Scribe's documentation here: https://scribe.knuckles.wtf/laravel/documenting/url-parametersMy route is as follows:
Route::get('/symbol/{symbol}/{interval}/{startDate}/{endDate}', [SymbolController::class, 'show']);
My comment above the show function is as follows:
@urlParam symbol string required The symbol ticker to get data for (case-sensitive) Example: AAPL
But instead of displaying my custom description in the generated documentation, it lists 'symbol_Symbol' as the parameter and has no description. I can override the description by changing the comment to
@urlParam symbol_Symbol string required The symbol ticker to get data for (case-sensitive) Example: AAPL
to match what is being generated, but I want the parameter to be correctly labelledsymbol
rather thansymbol_Symbol
.Other than that this is a great tool, thank you developers!
Docs
The text was updated successfully, but these errors were encountered: