Add Docstrings to Functions and File Headers #112
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
PR Feedback (click)
I created this PR to address this rule:
"Add docstrings to all functions and file headers."
Description
This PR addresses the issue of missing docstrings in functions and file headers in several files of the codebase. The aim is to improve code readability and understanding by providing clear and concise comments.
Changes were made in the following files:
app/Filament/Resources/TenantResource.php
app/Providers/EventServiceProvider.php
app/Providers/Filament/ContractorPanelProvider.php
app/Providers/Filament/LandlordPanelProvider.php
routes/landlord.php
app/Http/Controllers/Landlord/AuthController.php
(assumed to exist)In each file, a file header was added to describe the purpose of the file or class. For methods within these files, docstrings were added to explain the purpose, parameters, and return type of the methods.
Summary of Changes
TenantResource.php
,EventServiceProvider.php
,ContractorPanelProvider.php
,LandlordPanelProvider.php
,landlord.php
, andAuthController.php
.form
method inTenantResource.php
.panel
method inContractorPanelProvider.php
andLandlordPanelProvider.php
.AuthController.php
and added docstrings to its methods.These changes will greatly improve the readability and maintainability of the codebase.