Hands-On Full Stack Web Development with Angular 6 and Laravel 5

Adding Swagger definitions

Swagger generates the documentation for our notations that use API, a kind of self-writing of the framework itself, where, through tags, we can define what each element does. Let's start building our API documentation.

The first step is to add some definitions to the Bike model we just created in the previous steps.

1. Open the project/app/Bike.php model file and replace the code with the following lines:

<?phpnamespace App;use Illuminate\Database\Eloquent\Model;    /**    * @SWG\Definition(    * definition="Bike",    * required={"make", "model", "year", "mods"},    * @SWG\Property(    * property="make",    * type="string",    * description="Company name",    * example="Harley Davidson, Honda, Yamaha"    * ),    * @SWG\Property( * property="model", ...