Merge pull request #1502 from hydephp/normalize-code-comments

emmadesilva · web-flow · commit 56f3bf8e8d7a · 2023-12-14T11:47:39.000+01:00
Clean up and normalize class description comments
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -14,6 +14,7 @@ This serves two purposes:
 
 ### Changed
 - Shortened the path printed to console when using the dashboard to create a page in https://github.com/hydephp/develop/pull/1492
+- Code cleanup and style improvements in https://github.com/hydephp/develop/pull/1501 and https://github.com/hydephp/develop/pull/1502
 
 ### Deprecated
 - for soon-to-be removed features.
diff --git a/packages/framework/src/Console/Commands/BuildRssFeedCommand.php b/packages/framework/src/Console/Commands/BuildRssFeedCommand.php
@@ -8,7 +8,7 @@
 use LaravelZero\Framework\Commands\Command;
 
 /**
- * Hyde command to run the build process for the RSS feed.
+ * Run the build process for the RSS feed.
  */
 class BuildRssFeedCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/BuildSearchCommand.php b/packages/framework/src/Console/Commands/BuildSearchCommand.php
@@ -8,7 +8,7 @@
 use LaravelZero\Framework\Commands\Command;
 
 /**
- * Hyde command to run the build process for the documentation search index.
+ * Run the build process for the documentation search index.
  */
 class BuildSearchCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/BuildSiteCommand.php b/packages/framework/src/Console/Commands/BuildSiteCommand.php
@@ -20,7 +20,7 @@
 use function app;
 
 /**
- * Hyde Command to run the Build Process.
+ * Run the static site build process.
  */
 class BuildSiteCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/BuildSitemapCommand.php b/packages/framework/src/Console/Commands/BuildSitemapCommand.php
@@ -8,7 +8,7 @@
 use LaravelZero\Framework\Commands\Command;
 
 /**
- * Hyde command to run the build process for the sitemap.
+ * Run the build process for the sitemap.
  */
 class BuildSitemapCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/ChangeSourceDirectoryCommand.php b/packages/framework/src/Console/Commands/ChangeSourceDirectoryCommand.php
@@ -21,6 +21,9 @@
 use function basename;
 use function realpath;
 
+/**
+ * Change the source directory for your project.
+ */
 class ChangeSourceDirectoryCommand extends Command
 {
     /** @var string */
diff --git a/packages/framework/src/Console/Commands/DebugCommand.php b/packages/framework/src/Console/Commands/DebugCommand.php
@@ -14,7 +14,7 @@
 use function app;
 
 /**
- * Hyde Command to print debug information.
+ * Print debug information.
  */
 class DebugCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/MakePageCommand.php b/packages/framework/src/Console/Commands/MakePageCommand.php
@@ -15,7 +15,7 @@
 use function ucfirst;
 
 /**
- * Hyde Command to scaffold a new Markdown or Blade page file.
+ * Scaffold a new Markdown or Blade page file.
  */
 class MakePageCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/MakePostCommand.php b/packages/framework/src/Console/Commands/MakePostCommand.php
@@ -12,7 +12,7 @@
 use function ucwords;
 
 /**
- * Hyde Command to scaffold a new Markdown Post.
+ * Scaffold a new Markdown blog post file.
  */
 class MakePostCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/PackageDiscoverCommand.php b/packages/framework/src/Console/Commands/PackageDiscoverCommand.php
@@ -8,6 +8,9 @@
 use Illuminate\Foundation\Console\PackageDiscoverCommand as BaseCommand;
 use Illuminate\Foundation\PackageManifest;
 
+/**
+ * Extended package discovery command to use the custom manifest path.
+ */
 class PackageDiscoverCommand extends BaseCommand
 {
     /** @var true */
diff --git a/packages/framework/src/Console/Commands/PublishConfigsCommand.php b/packages/framework/src/Console/Commands/PublishConfigsCommand.php
@@ -12,7 +12,7 @@
 use function sprintf;
 
 /**
- * Publish the Hyde Config Files.
+ * Publish the Hyde config files.
  */
 class PublishConfigsCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/PublishHomepageCommand.php b/packages/framework/src/Console/Commands/PublishHomepageCommand.php
@@ -18,7 +18,7 @@
 use function strstr;
 
 /**
- * Publish one of the default homepages.
+ * Publish one of the default homepages to index.blade.php.
  */
 class PublishHomepageCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/RebuildPageCommand.php b/packages/framework/src/Console/Commands/RebuildPageCommand.php
@@ -24,7 +24,7 @@
 use function unslash;
 
 /**
- * Hyde Command to build a single static site file.
+ * Build a single static site file.
  */
 class RebuildPageCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/RouteListCommand.php b/packages/framework/src/Console/Commands/RouteListCommand.php
@@ -15,7 +15,7 @@
 use function sprintf;
 
 /**
- * Hyde command to display the list of site routes.
+ * Display the list of site routes.
  */
 class RouteListCommand extends Command
 {
diff --git a/packages/framework/src/Console/Commands/ValidateCommand.php b/packages/framework/src/Console/Commands/ValidateCommand.php
@@ -13,6 +13,9 @@
 use function sprintf;
 use function sizeof;
 
+/**
+ * Run a series of tests to validate your setup and help you optimize your site.
+ */
 class ValidateCommand extends Command
 {
     use TracksExecutionTime;
diff --git a/packages/framework/src/Foundation/Kernel/RouteCollection.php b/packages/framework/src/Foundation/Kernel/RouteCollection.php
@@ -10,7 +10,8 @@
 use Hyde\Support\Models\Route;
 
 /**
- * The RouteCollection contains all the routes, making it the Pseudo-Router for Hyde.
+ * The RouteCollection contains all the page routes, making it the pseudo-router for Hyde,
+ * as it maps each page to the eventual URL that will be used to access it once built.
  *
  * @template T of \Hyde\Support\Models\Route
  *
diff --git a/packages/framework/src/Framework/Actions/StaticPageBuilder.php b/packages/framework/src/Framework/Actions/StaticPageBuilder.php
@@ -10,7 +10,7 @@
 use Hyde\Pages\Concerns\HydePage;
 
 /**
- * Converts a Page Model into a static HTML page.
+ * Converts a Hyde page object into a static HTML page.
  */
 class StaticPageBuilder
 {
diff --git a/packages/framework/src/Framework/Concerns/InteractsWithFrontMatter.php b/packages/framework/src/Framework/Concerns/InteractsWithFrontMatter.php
@@ -11,7 +11,7 @@
 use function blank;
 
 /**
- * Adds methods to a class to allow it to fluently interact with the front matter.
+ * Adds methods to a class to allow it to fluently interact with its front matter.
  */
 trait InteractsWithFrontMatter
 {
diff --git a/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php b/packages/framework/src/Framework/Features/Blogging/Models/PostAuthor.php
@@ -13,7 +13,7 @@
 use function is_string;
 
 /**
- * The Post Author model object.
+ * Object representation of a post author for the site.
  */
 class PostAuthor implements Stringable
 {
diff --git a/packages/publications/src/Commands/MakePublicationCommand.php b/packages/publications/src/Commands/MakePublicationCommand.php
@@ -25,7 +25,7 @@
 use function str_starts_with;
 
 /**
- * Hyde Command to create a new publication for a given publication type.
+ * Hyde command to create a new publication for a given publication type.
  *
  * @see \Hyde\Publications\Actions\CreatesNewPublicationPage
  * @see \Hyde\Publications\Testing\Feature\MakePublicationCommandTest
diff --git a/packages/publications/src/Commands/MakePublicationTypeCommand.php b/packages/publications/src/Commands/MakePublicationTypeCommand.php
@@ -24,7 +24,7 @@
 use function strtolower;
 
 /**
- * Hyde Command to create a new publication type.
+ * Hyde command to create a new publication type.
  *
  * @see \Hyde\Publications\Actions\CreatesNewPublicationType
  * @see \Hyde\Publications\Testing\Feature\MakePublicationTypeCommandTest
diff --git a/packages/publications/src/Commands/SeedPublicationCommand.php b/packages/publications/src/Commands/SeedPublicationCommand.php
@@ -16,7 +16,7 @@
 use function sprintf;
 
 /**
- * Hyde Command to seed publication files for a publication type.
+ * Hyde command to seed publication files for a publication type.
  *
  * @see \Hyde\Publications\Actions\SeedsPublicationFiles
  * @see \Hyde\Publications\Testing\Feature\SeedPublicationCommandTest
diff --git a/packages/publications/src/Commands/ValidatePublicationTypesCommand.php b/packages/publications/src/Commands/ValidatePublicationTypesCommand.php
@@ -23,7 +23,7 @@
 use function sprintf;
 
 /**
- * Hyde Command to validate all publication schema file..
+ * Hyde command to validate all publication schema file..
  *
  * @see \Hyde\Publications\Testing\Feature\ValidatePublicationTypesCommandTest
  *
diff --git a/packages/publications/src/Commands/ValidatePublicationsCommand.php b/packages/publications/src/Commands/ValidatePublicationsCommand.php
@@ -34,7 +34,7 @@
 use function substr_count;
 
 /**
- * Hyde Command to validate one or all publications.
+ * Hyde command to validate one or all publications.
  *
  * @see \Hyde\Publications\Testing\Feature\ValidatePublicationsCommandTest
  *

Original file line number	Diff line number	Diff line change
`@@ -8,7 +8,7 @@`
`8`	`8`	`use LaravelZero\Framework\Commands\Command;`
`9`	`9`
`10`	`10`	`/**`
`11`		`- * Hyde command to run the build process for the RSS feed.`
	`11`	`+ * Run the build process for the RSS feed.`
`12`	`12`	`*/`
`13`	`13`	`class BuildRssFeedCommand extends Command`
`14`	`14`	`{`
Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@`
`20`	`20`	`use function app;`
`21`	`21`
`22`	`22`	`/**`
`23`		`- * Hyde Command to run the Build Process.`
	`23`	`+ * Run the static site build process.`
`24`	`24`	`*/`
`25`	`25`	`class BuildSiteCommand extends Command`
`26`	`26`	`{`
Original file line number	Diff line number	Diff line change
`@@ -21,6 +21,9 @@`
`21`	`21`	`use function basename;`
`22`	`22`	`use function realpath;`
`23`	`23`
	`24`	`+/**`
	`25`	`+ * Change the source directory for your project.`
	`26`	`+ */`
`24`	`27`	`class ChangeSourceDirectoryCommand extends Command`
`25`	`28`	`{`
`26`	`29`	`/** @var string */`
Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@`
`14`	`14`	`use function app;`
`15`	`15`
`16`	`16`	`/**`
`17`		`- * Hyde Command to print debug information.`
	`17`	`+ * Print debug information.`
`18`	`18`	`*/`
`19`	`19`	`class DebugCommand extends Command`
`20`	`20`	`{`
Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,7 @@`
`15`	`15`	`use function ucfirst;`
`16`	`16`
`17`	`17`	`/**`
`18`		`- * Hyde Command to scaffold a new Markdown or Blade page file.`
	`18`	`+ * Scaffold a new Markdown or Blade page file.`
`19`	`19`	`*/`
`20`	`20`	`class MakePageCommand extends Command`
`21`	`21`	`{`
Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@`
`12`	`12`	`use function ucwords;`
`13`	`13`
`14`	`14`	`/**`
`15`		`- * Hyde Command to scaffold a new Markdown Post.`
	`15`	`+ * Scaffold a new Markdown blog post file.`
`16`	`16`	`*/`
`17`	`17`	`class MakePostCommand extends Command`
`18`	`18`	`{`
Original file line number	Diff line number	Diff line change
`@@ -8,6 +8,9 @@`
`8`	`8`	`use Illuminate\Foundation\Console\PackageDiscoverCommand as BaseCommand;`
`9`	`9`	`use Illuminate\Foundation\PackageManifest;`
`10`	`10`
	`11`	`+/**`
	`12`	`+ * Extended package discovery command to use the custom manifest path.`
	`13`	`+ */`
`11`	`14`	`class PackageDiscoverCommand extends BaseCommand`
`12`	`15`	`{`
`13`	`16`	`/** @var true */`