Flesh out and hook up migration guide for v6

Author: DerManoMann

docs/.vitepress/config.js

@@ -20,6 +20,7 @@ function getGuideSidebar() {
     {
       text: 'Upgrading',
       items: [
+        { text: 'Migration from 5.x to 6.x', link: '/guide/migrating-to-v6' },
         { text: 'Migration from 4.x to 5.x', link: '/guide/migrating-to-v5' },
         { text: 'Migration from 3.x to 4.x', link: '/guide/migrating-to-v4' },
         { text: 'Migration from 2.x to 3.x', link: '/guide/migrating-to-v3' },
@@ -64,7 +65,7 @@ module.exports = {
   srcExclude: [
       'examples/Readme.md'
   ],
-  themeConfig: {    
+  themeConfig: {
     socialLinks: [
       { icon: 'github', link: 'https://github.com/zircote/swagger-php' },
     ],

docs/guide/migrating-to-v6.md

@@ -10,5 +10,15 @@ v6 is mostly a cleanup release with updated dependencies. The main changes are:
 For most installations upgrading should not require any changes.
 
 ## Removed deprecated elements
-### `\Openapi\Generator::getProcessors()` and `\Openapi\Generator::setProcessors()`
+### Methods `\Openapi\Generator::getProcessors()` and `\Openapi\Generator::setProcessors()`
 Use `getProcessorPipeline()` and `setProcessorPipeline(new Pipeline(...))` methods instead
+
+### Static method `\Openapi\Generator::scan()`
+Main entry point into the `Generator` is now the **non-static** `generate()` method:
+```php
+(new Generator())->generate(/* ... */);
+```
+
+### `Utils` helper
+Most methods in the class were internal to start with and the `Util::finder()` factory methods is now replaced with
+the new `SourceFinder` class.

src/Processors/Concerns/DocblockTrait.php

@@ -37,7 +37,7 @@ public function isRoot(OA\AbstractAnnotation $annotation): bool
             OA\Schema::class => true,
             OAT\Schema::class => true,
         ];
-        // try to find best root match
+        // try to find the best root match
         foreach ($matchPriorityMap as $className => $strict) {
             foreach ($annotation->_context->annotations as $contextAnnotation) {
                 if ($strict) {