Remove docblocks in the controller

Author: ajcastro

app/Http/Controllers/SideProjectController.php

@@ -8,37 +8,19 @@
 use League\Fractal\Manager;
 use League\Fractal\Resource\Item;
 
-/**
- * @group Side Projects
- */
+
 class SideProjectController extends Controller
 {
     public function __construct()
     {
         $this->middleware('auth')->only('store');
     }
 
-    /**
-     * View all side projects
-     *
-     * This endpoint's response was gotten via a "response call"—
-     * Scribe called our API in a test environment to get a sample response.
-     */
     public function index()
     {
         return SideProject::all();
     }
 
-    /**
-     * Start a new side project
-     *
-     * _Even though we both know you'll never finish it._
-     *
-     * This endpoint's body parameters were automatically generated by Scribe
-     * from the controller's code. Check out the source! </aside>
-     *
-     * @authenticated
-     */
     public function store(Request $request)
     {
         $validated = $request->validate([
@@ -57,47 +39,23 @@ public function store(Request $request)
         return SideProject::create($validated);
     }
 
-    /**
-     * View a side project
-     *
-     * This endpoint's response uses a Fractal transformer, so we tell Scribe that using an annotation,
-     * and it figures out how to generate a sample. The 404 sample is gotten from a "response file".
-     *
-     * <aside class="success">Also, pretty cool: this endpoint's (and many others') URL parameters were figured out entirely by Scribe!</aside>
-     *
-     * @transformer  App\Http\Transformers\SideProjectTransformer
-     * @transformerModel App\Models\SideProject with=owner
-     */
     public function show(SideProject $sideProject)
     {
         $fractal = new Manager();
         $resource = new Item($sideProject, new SideProjectTransformer());
         return $fractal->createData($resource)->toArray();
     }
 
-    /**
-     * Update a side project
-     *
-     */
     public function update(Request $request, SideProject $sideProject)
     {
         //
     }
 
-    /**
-     * Delete a side project
-     *
-     */
     public function destroy(SideProject $sideProject)
     {
         //
     }
 
-    /**
-     * Finish a side project
-     *
-     * Hmmm.🤔
-     */
     public function finish(SideProject $sideProject)
     {
         //

app/Http/Controllers/UserController.php

@@ -12,26 +12,11 @@
  */
 class UserController extends Controller
 {
-    /**
-     * View all users
-     *
-     * This endpoint uses a custom Scribe strategy that parses a
-     * `@usesPagination` annotation to add some query parameters.
-     *
-     * The sample response is gotten by Scribe making a test API call (aka "response call").
-     *
-     * @usesPagination
-     */
     public function index()
     {
         return UserResource::collection(User::all());
     }
 
-    /**
-     * Create a user
-     *
-     * This endpoint's body parameters are automatically generated from a FormRequest.
-     */
     public function store(CreateUserRequest $request)
     {
         /** @var User $user */
@@ -40,55 +25,22 @@ public function store(CreateUserRequest $request)
         return response(['user' => $user, 'token' => $token->plainTextToken], 201);
     }
 
-    /**
-     * Authenticate
-     *
-     * Get a new API token.
-     *
-     * <aside>Yes, we know you can impersonate any user.🙄</aside>
-     *
-     * @response {"token": "2|KLDoUXc68Ko0JaFDZoX9qYkUqWglwdGxQsvTGBCg"}
-     * @responseField token The new API token. Valid forever.
-     */
     public function authenticate($id)
     {
         $token = User::findOrFail($id)->createToken('default');
         return ['token' => $token->plainTextToken];
     }
 
-    /**
-     * Fetch a user
-     *
-     * This endpoint's response uses an Eloquent API resource, so we tell Scribe that using an annotation,
-     * and it figures out how to generate a sample. The 404 sample is gotten from a "response file".
-     *
-     * @apiResource App\Http\Resources\UserResource
-     * @apiResourceModel App\Models\User with=sideProjects
-     * @responseFile 404 scenario="User not found" responses/not_found.json {"resource": "user"}
-     */
     public function show($id)
     {
         return new UserResource(User::findOrFail($id));
     }
 
-    /**
-     * Update the specified resource in storage.
-     *
-     * @param  \Illuminate\Http\Request  $request
-     * @param  int  $id
-     * @return \Illuminate\Http\Response
-     */
     public function update(Request $request, $id)
     {
         //
     }
 
-    /**
-     * Remove the specified resource from storage.
-     *
-     * @param  int  $id
-     * @return \Illuminate\Http\Response
-     */
     public function destroy($id)
     {
         //