From aa44e02b0234085d5305b1f476ef87603eca6f31 Mon Sep 17 00:00:00 2001
From: Simon 'Firesphere' Erkelens <github@casa-laguna.net>
Date: Fri, 27 Dec 2019 13:50:07 +1300
Subject: [PATCH] Add file summaries

Store summaries
---
 src/Admins/SearchAdmin.php              |  7 +++++++
 src/Extensions/DataObjectExtension.php  |  9 ++++++++-
 src/Extensions/GridFieldExtension.php   |  8 +++++++-
 src/Factories/DocumentFactory.php       |  8 +++++++-
 src/Factories/QueryComponentFactory.php |  8 +++++++-
 src/Forms/SearchForm.php                |  8 +++++++-
 src/Helpers/DataResolver.php            |  7 +++++++
 src/Helpers/FieldResolver.php           |  7 +++++++
 src/Helpers/SolrLogger.php              |  8 +++++++-
 src/Helpers/Statics.php                 |  8 +++++++-
 src/Helpers/Synonyms.php                |  8 +++++++-
 src/Indexes/BaseIndex.php               |  8 +++++++-
 src/Interfaces/ConfigStore.php          |  9 ++++++++-
 src/Interfaces/SiteStateInterface.php   |  9 ++++++++-
 src/Jobs/ClearDirtyClassesJob.php       |  9 ++++++++-
 src/Jobs/SolrConfigureJob.php           |  8 +++++++-
 src/Jobs/SolrIndexJob.php               |  8 +++++++-
 src/Models/DirtyClass.php               |  8 +++++++-
 src/Models/SearchSynonym.php            | 10 ++++++++--
 src/Models/SolrLog.php                  |  8 +++++++-
 src/Queries/BaseQuery.php               |  8 +++++++-
 src/Results/SearchResult.php            |  8 +++++++-
 src/Services/SchemaService.php          |  8 +++++++-
 src/Services/SolrCoreService.php        |  7 +++++++
 src/States/SiteState.php                |  8 ++++++++
 src/Stores/FileConfigStore.php          |  8 +++++++-
 src/Stores/PostConfigStore.php          |  8 +++++++-
 27 files changed, 195 insertions(+), 23 deletions(-)

diff --git a/src/Admins/SearchAdmin.php b/src/Admins/SearchAdmin.php
index a90afa7c..6d6ad770 100644
--- a/src/Admins/SearchAdmin.php
+++ b/src/Admins/SearchAdmin.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * class SearchAdmin|Firesphere\SolrSearch\Admins\SearchAdmin Base admin for Synonyms, logs and dirty classes
+ *
+ * @package Firesphere\SolrSearch\Admins
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Admins;
 
diff --git a/src/Extensions/DataObjectExtension.php b/src/Extensions/DataObjectExtension.php
index 09acb694..dce5743c 100644
--- a/src/Extensions/DataObjectExtension.php
+++ b/src/Extensions/DataObjectExtension.php
@@ -1,5 +1,12 @@
 <?php
-
+/**
+ * class DataObjectExtension|Firesphere\SolrSearch\Extensions\DataObjectExtension Adds checking if changes should be
+ * pushed to Solr
+ *
+ * @package Firesphere\SolrSearch\Extensions
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Extensions;
 
diff --git a/src/Extensions/GridFieldExtension.php b/src/Extensions/GridFieldExtension.php
index fbb709a7..6fdc9831 100644
--- a/src/Extensions/GridFieldExtension.php
+++ b/src/Extensions/GridFieldExtension.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class GridFieldExtension|Firesphere\SolrSearch\Extensions\GridFieldExtension Add colours to the GridField
+ *
+ * @package Firesphere\SolrSearch\Extensions
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Extensions;
 
diff --git a/src/Factories/DocumentFactory.php b/src/Factories/DocumentFactory.php
index 8946d9bd..f9b3160d 100644
--- a/src/Factories/DocumentFactory.php
+++ b/src/Factories/DocumentFactory.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class DocumentFactory|Firesphere\SolrSearch\Factories\DocumentFactory Build a Solarium document to push
+ *
+ * @package Firesphere\SolrSearch\Factories
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Factories;
 
diff --git a/src/Factories/QueryComponentFactory.php b/src/Factories/QueryComponentFactory.php
index 2928441c..02821f22 100644
--- a/src/Factories/QueryComponentFactory.php
+++ b/src/Factories/QueryComponentFactory.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class QueryComponentFactory|Firesphere\SolrSearch\Factories\QueryComponentFactory Build a Query component
+ *
+ * @package Firesphere\SolrSearch\Factories
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Factories;
 
diff --git a/src/Forms/SearchForm.php b/src/Forms/SearchForm.php
index fe32dfbc..982ed3df 100644
--- a/src/Forms/SearchForm.php
+++ b/src/Forms/SearchForm.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class SearchForm|Firesphere\SolrSearch\Forms basic search form
+ *
+ * @package Firesphere\SolrSearch\Factories
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Forms;
 
diff --git a/src/Helpers/DataResolver.php b/src/Helpers/DataResolver.php
index 44127ca3..5c04ad06 100644
--- a/src/Helpers/DataResolver.php
+++ b/src/Helpers/DataResolver.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * class DataResolver|Firesphere\SolrSearch\Helpers\DataResolver Identify content or relational content of a DataObject
+ *
+ * @package Firesphere\SolrSearch\Helpers
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Helpers;
 
diff --git a/src/Helpers/FieldResolver.php b/src/Helpers/FieldResolver.php
index 40434c64..6bbac2a1 100644
--- a/src/Helpers/FieldResolver.php
+++ b/src/Helpers/FieldResolver.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * class FieldResolver|Firesphere\SolrSearch\Helpers\FieldResolver Identify fields or relations in a DataObject
+ *
+ * @package Firesphere\SolrSearch\Helpers
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Helpers;
 
diff --git a/src/Helpers/SolrLogger.php b/src/Helpers/SolrLogger.php
index dfe5059b..ca04865f 100644
--- a/src/Helpers/SolrLogger.php
+++ b/src/Helpers/SolrLogger.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class SolrLogger|Firesphere\SolrSearch\Helpers\SolrLogger Log errors to the Database
+ *
+ * @package Firesphere\SolrSearch\Helpers
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Helpers;
 
diff --git a/src/Helpers/Statics.php b/src/Helpers/Statics.php
index cd1e24d9..3727994c 100644
--- a/src/Helpers/Statics.php
+++ b/src/Helpers/Statics.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class Statics|Firesphere\SolrSearch\Helpers\Statics TypeMap support
+ *
+ * @package Firesphere\SolrSearch\Helpers
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Helpers;
 
diff --git a/src/Helpers/Synonyms.php b/src/Helpers/Synonyms.php
index 63cdcdb8..9487c5c9 100644
--- a/src/Helpers/Synonyms.php
+++ b/src/Helpers/Synonyms.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class Synonyms|Firesphere\SolrSearch\Helpers\Synonyms Get the default UK-US synonyms helper
+ *
+ * @package Firesphere\SolrSearch\Helpers
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Helpers;
 
diff --git a/src/Indexes/BaseIndex.php b/src/Indexes/BaseIndex.php
index e4ac59d5..239b2a24 100644
--- a/src/Indexes/BaseIndex.php
+++ b/src/Indexes/BaseIndex.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class BaseIndex|Firesphere\SolrSearch\Indexes\BaseIndex is the base for indexing items
+ *
+ * @package Firesphere\SolrSearch\Indexes
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Indexes;
 
diff --git a/src/Interfaces/ConfigStore.php b/src/Interfaces/ConfigStore.php
index 0476e520..92be09dc 100644
--- a/src/Interfaces/ConfigStore.php
+++ b/src/Interfaces/ConfigStore.php
@@ -1,5 +1,12 @@
 <?php
-
+/**
+ * class ConfigStore|Firesphere\SolrSearch\Interfaces\ConfigStore Interface for managing the
+ * store configuration of a core
+ *
+ * @package Firesphere\SolrSearch\Interfaces
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Interfaces;
 
diff --git a/src/Interfaces/SiteStateInterface.php b/src/Interfaces/SiteStateInterface.php
index 39818aec..90fc8ec5 100644
--- a/src/Interfaces/SiteStateInterface.php
+++ b/src/Interfaces/SiteStateInterface.php
@@ -1,5 +1,12 @@
 <?php
-
+/**
+ * class SiteStateInterface|Firesphere\SolrSearch\Interfaces\SiteStateInterface Interface for managing the
+ * state of a site
+ *
+ * @package Firesphere\SolrSearch\Interfaces
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Interfaces;
 
diff --git a/src/Jobs/ClearDirtyClassesJob.php b/src/Jobs/ClearDirtyClassesJob.php
index 4a2c3d73..20b2fd2c 100644
--- a/src/Jobs/ClearDirtyClassesJob.php
+++ b/src/Jobs/ClearDirtyClassesJob.php
@@ -1,5 +1,12 @@
 <?php
-
+/**
+ * class ClearDirtyClassesJob|Firesphere\SolrSearch\Jobs\ClearDirtyClassesJob Clear out the dirty classes by pushing
+ * them again to solr
+ *
+ * @package Firesphere\SolrSearch\Jobs
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Jobs;
 
diff --git a/src/Jobs/SolrConfigureJob.php b/src/Jobs/SolrConfigureJob.php
index b1fb94e8..f92f7564 100644
--- a/src/Jobs/SolrConfigureJob.php
+++ b/src/Jobs/SolrConfigureJob.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class SolrConfigureJob|Firesphere\SolrSearch\Jobs\SolrConfigureJob Configure cores from the CMS
+ *
+ * @package Firesphere\SolrSearch\Jobs
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Jobs;
 
diff --git a/src/Jobs/SolrIndexJob.php b/src/Jobs/SolrIndexJob.php
index 8853c2fb..1b1b6d16 100644
--- a/src/Jobs/SolrIndexJob.php
+++ b/src/Jobs/SolrIndexJob.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class SolrIndexJob|Firesphere\SolrSearch\Jobs\SolrIndexJob Index items from the CMS through a QueuedJob
+ *
+ * @package Firesphere\SolrSearch\Jobs
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Jobs;
 
diff --git a/src/Models/DirtyClass.php b/src/Models/DirtyClass.php
index 780a8b5d..c0f51f0e 100644
--- a/src/Models/DirtyClass.php
+++ b/src/Models/DirtyClass.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class DirtyClass|Firesphere\SolrSearch\Models\DirtyClass Store Dirty classes for re-indexing
+ *
+ * @package Firesphere\SolrSearch\Models
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Models;
 
diff --git a/src/Models/SearchSynonym.php b/src/Models/SearchSynonym.php
index d2e07b30..a4536492 100644
--- a/src/Models/SearchSynonym.php
+++ b/src/Models/SearchSynonym.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class SearchSynonym|Firesphere\SolrSearch\Models\SearchSynonym Object for handling synonyms from the CMS
+ *
+ * @package Firesphere\SolrSearch\Models
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Models;
 
@@ -10,7 +16,7 @@
  * Class \Firesphere\SolrSearch\Models\SearchSynonym
  * Manageable synonyms in the CMS
  *
- * @package Firesphere\SolrSerach\Models
+ * @package Firesphere\SolrSearch\Models
  * @property string $Keyword
  * @property string $Synonym
  */
diff --git a/src/Models/SolrLog.php b/src/Models/SolrLog.php
index 5bdbe172..85737275 100644
--- a/src/Models/SolrLog.php
+++ b/src/Models/SolrLog.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class SolrLog|Firesphere\SolrSearch\Models\SolrLog Solr logging to be read from the CMS
+ *
+ * @package Firesphere\SolrSearch\Models
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Models;
 
diff --git a/src/Queries/BaseQuery.php b/src/Queries/BaseQuery.php
index a3b843fa..841cf0c4 100644
--- a/src/Queries/BaseQuery.php
+++ b/src/Queries/BaseQuery.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class BaseQuery|Firesphere\SolrSearch\Queries\BaseQuery Base of a Solr Query
+ *
+ * @package Firesphere\SolrSearch\Queries
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Queries;
 
diff --git a/src/Results/SearchResult.php b/src/Results/SearchResult.php
index cb23498a..2605b83e 100644
--- a/src/Results/SearchResult.php
+++ b/src/Results/SearchResult.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class SearchResult|Firesphere\SolrSearch\Results\SearchResult Result of a query
+ *
+ * @package Firesphere\SolrSearch\Results
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Results;
 
diff --git a/src/Services/SchemaService.php b/src/Services/SchemaService.php
index f43724b0..d361a106 100644
--- a/src/Services/SchemaService.php
+++ b/src/Services/SchemaService.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class SchemaService|Firesphere\SolrSearch\Services\SchemaService Base service for generating a schema
+ *
+ * @package Firesphere\SolrSearch\Services
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Services;
 
diff --git a/src/Services/SolrCoreService.php b/src/Services/SolrCoreService.php
index 8a36303d..ff3c90d3 100644
--- a/src/Services/SolrCoreService.php
+++ b/src/Services/SolrCoreService.php
@@ -1,4 +1,11 @@
 <?php
+/**
+ * class SolrCoreService|Firesphere\SolrSearch\Services\SolrCoreService Base service for communicating with the core
+ *
+ * @package Firesphere\SolrSearch\Services
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Services;
 
diff --git a/src/States/SiteState.php b/src/States/SiteState.php
index df82e991..a2c64215 100644
--- a/src/States/SiteState.php
+++ b/src/States/SiteState.php
@@ -1,4 +1,12 @@
 <?php
+/**
+ * class SiteState|Firesphere\SolrSearch\States\SiteState Base implementation of SiteState to be used by e.g.
+ * the Fluent extension
+ *
+ * @package Firesphere\SolrSearch\States
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 
 namespace Firesphere\SolrSearch\States;
diff --git a/src/Stores/FileConfigStore.php b/src/Stores/FileConfigStore.php
index 445c6893..1b878cbe 100644
--- a/src/Stores/FileConfigStore.php
+++ b/src/Stores/FileConfigStore.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class FileConfigStore|Firesphere\SolrSearch\Stores\FileConfigStore File storage configuration for a core
+ *
+ * @package Firesphere\SolrSearch\Stores
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Stores;
 
diff --git a/src/Stores/PostConfigStore.php b/src/Stores/PostConfigStore.php
index c22ab976..1f024b58 100644
--- a/src/Stores/PostConfigStore.php
+++ b/src/Stores/PostConfigStore.php
@@ -1,5 +1,11 @@
 <?php
-
+/**
+ * class PostConfigStore|Firesphere\SolrSearch\Stores\PostConfigStore Post storage configuration for a core
+ *
+ * @package Firesphere\SolrSearch\Stores
+ * @author Simon `Firesphere` Erkelens; Marco `Sheepy` Hermo
+ * @copyright Copyright (c) 2018 - now() Firesphere & Sheepy
+ */
 
 namespace Firesphere\SolrSearch\Stores;