Remove deprecated Factory usage from documentation and examples

[Copilot]

The documentation site still referenced the deprecated Factory::create() pattern removed in v6.0, causing confusion about current usage.

Changes

Documentation (docs/index.md)

• Replaced all Factory instantiation with direct new FeedIo($client, $logger) pattern
• Updated examples to use PSR-18 client discovery and Symfony HTTP Client

Migration guide (docs/upgrades/UPGRADE-6.0.md)

• Added before/after examples for Factory → direct instantiation migration
• Included patterns for basic usage, logging, and Guzzle-specific setups

Examples

• Updated 5 example files to remove Factory references
• Replaced Factory\Builder\MonologBuilder with direct Monolog instantiation
• Replaced Factory::create() with new Client(Psr18ClientDiscovery::find())

Before (5.x)

use \FeedIo\Factory;

$feedIo = Factory::create()->getFeedIo();

After (6.0+)

use \FeedIo\Adapter\Http\Client;
use \Http\Discovery\Psr18ClientDiscovery;

$client = new Client(Psr18ClientDiscovery::find());
$feedIo = new \FeedIo\FeedIo($client);

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/Nyholm/psr7/zipball/a71f2b11690f4b24d099d6b16690a90ae14fc6f3
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/PHP-CS-Fixer/PHP-CS-Fixer/zipball/399a128ff2fdaf4281e4e79b755693286cdf325c
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/Seldaek/monolog/zipball/5cf826f2991858b54d5c3809bee745560a1042a7
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/clue/reactphp-ndjson/zipball/392dc165fce93b5bb5c637b67e59619223c931b0
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/clue/stream-filter/zipball/049509fef80032cb3f051595029ab75b49a3c2f7
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/composer/pcre/zipball/04229f163664973f68f38f6f73d917799168ef24
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/XaZ7xB /usr/bin/composer install --prefer-dist --no-progress (http block)
• https://api.github.com/repos/composer/semver/zipball/4313d26ada5e0c4edfbd1dc481a92ff7bff91f12
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/composer/xdebug-handler/zipball/6c1925561632e83d60a44492e0b344cf48ab85ef
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/doctrine/deprecations/zipball/459c2f5dd3d6a4633d3b5f46ee2b1c40f57d3f38
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/guzzle/guzzle/zipball/b51ac707cfa420b7bfd4e4d5e510ba8008e822b4
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/guzzle/promises/zipball/481557b130ef3790cf82b713667b43030dc9c957
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/guzzle/psr7/zipball/21dc724a0583619cd1652f673303492272778051
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/igorw/evenement/zipball/0a16b0d71ab13284339abb99d9d2bd813640efbc
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-fig/container/zipball/c71ecc56dfe541dbd90c5360474fbc405f8d5963
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/XaZ7xB /usr/bin/composer install --prefer-dist --no-progress (http block)
• https://api.github.com/repos/php-fig/event-dispatcher/zipball/dbefd12671e8a14ec7f180cab83036ed26714bb0
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-fig/http-client/zipball/bb5906edc1c324c9a05aa0873d40117941e5fa90
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-fig/http-factory/zipball/2b4765fddfe3b508ac62f829e852b1501d3f6e8a
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-fig/http-message/zipball/402d35bcb92c70c026d1a6a9883f06b2ead23d71
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-fig/log/zipball/f16e1d5863e37f8d8c2a01719f5b34baa2b714d3
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-http/client-common/zipball/0cfe9858ab9d3b213041b947c881d5b19ceeca46
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-http/discovery/zipball/82fe4c73ef3363caed49ff8dd1539ba06044910d
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/XaZ7xB /usr/bin/composer install --prefer-dist --no-progress (http block)
• https://api.github.com/repos/php-http/guzzle7-adapter/zipball/03a415fde709c2f25539790fecf4d9a31bc3d0eb
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-http/httplug/zipball/5cad731844891a4c282f3f3e1b582c46839d22f4
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-http/message/zipball/06dd5e8562f84e641bf929bfe699ee0f5ce8080a
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-http/mock-client/zipball/81f558234421f7da58ed015604a03808996017d0
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/php-http/promise/zipball/fc85b1fba37c169a69a07ef0d5a8075770cc1f83
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/phpDocumentor/ReflectionCommon/zipball/1d01c49d4ed62f25aa84a747ad35d5a16924662b
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/phpDocumentor/ReflectionDocBlock/zipball/92dde6a5919e34835c506ac8c523ef095a95ed62
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/phpDocumentor/TypeResolver/zipball/679e3ce485b99e84c775d28e2e96fade9a7fb50a
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/phpstan/phpdoc-parser/zipball/9b30d6fd026b2c132b3985ce6b23bec09ab3aa68
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/ralouphie/getallheaders/zipball/120b605dfeb996808c31b6477290a714d356e822
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/reactphp/cache/zipball/d47c472b64aa5608225f47965a484b75c7817d5b
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/reactphp/child-process/zipball/1721e2b93d89b745664353b9cfc8f155ba8a6159
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/reactphp/dns/zipball/eb8ae001b5a455665c89c1df97f6fb682f8fb0f5
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/reactphp/event-loop/zipball/bbe0bd8c51ffc05ee43f1729087ed3bdf7d53354
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/reactphp/promise/zipball/8a164643313c71354582dc850b42b33fa12a4b63
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/reactphp/socket/zipball/23e4ff33ea3e160d2d1f59a0e6050e4b0fb0eac1
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/reactphp/stream/zipball/1e5b0acb8fe55143b5b426817155190eb6f5b18d
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/diff/zipball/ba01945089c3a293b01ba9badc29ad55b106b0bc
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/global-state/zipball/bca7df1f32ee6fe93b4d4a9abbf69e13a4ada2c9
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/object-enumerator/zipball/5c9eeac41b290a3712d88851518825ad78f45c71
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/object-reflector/zipball/b4f479ebdbf63ac605d183ece17d8d7fe49c15c7
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/recursion-context/zipball/e75bd0f07204fec2a0af9b0f3cfe97d05f92efc1
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/resource-operations/zipball/05d5692a7993ecccd56a03e40cd7e5b09b1d404e
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/type/zipball/b8cd8a1c753c90bc1a0f5372170e3e489136f914
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/sebastianbergmann/version/zipball/c6c1022351a901512170118436c764e473f6de8c
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/console/zipball/7d29659bc3c9d8e9a34e2c3414ef9e9e003e6cf3
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/deprecation-contracts/zipball/63afe740e99a13ba87ec199bb07bbdee937a5b62
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/XaZ7xB /usr/bin/composer install --prefer-dist --no-progress (http block)
• https://api.github.com/repos/symfony/event-dispatcher-contracts/zipball/59eb412e93815df44f05f342958efa9f46b1e586
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/event-dispatcher/zipball/0ffc48080ab3e9132ea74ef4e09d8dcf26bf897e
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/filesystem/zipball/4856c9cf585d5a0313d8d35afd681a526f038dd3
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/finder/zipball/1d0e8266248c5d9ab6a87e3789e6dc482af3c9c7
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/options-resolver/zipball/368128ad168f20e22c32159b9f761e456cec0c78
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-ctype/zipball/a3cc8b044a6ea513310cbd48ef7333b384945638
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-intl-grapheme/zipball/b9123926e3b7bc2f98c02ad54f6a4b02b91a8abe
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-intl-normalizer/zipball/3833d7255cc303546435cb650316bff708a1c75c
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-mbstring/zipball/6d857f4d76bd4b343eac26d6b539585d2bc56493
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-php80/zipball/0cc9dd0f17f61d8131e7df6b84bd344899fe2608
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/symfony/polyfill-php81/zipball/4a4cfc2d253c21a5ad0e53071df248ed48c6ce5c
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/XaZ7xB /usr/bin/composer install --prefer-dist --no-progress (http block)
• https://api.github.com/repos/symfony/process/zipball/e2a61c16af36c9a07e5c9906498b73e091949a20
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/XaZ7xB /usr/bin/composer install --prefer-dist --no-progress (http block)
• https://api.github.com/repos/symfony/service-contracts/zipball/f021b05a130d35510bd6b25fe9053c2a8a15d5d4
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/XaZ7xB /usr/bin/composer install --prefer-dist --no-progress (http block)
• https://api.github.com/repos/symfony/stopwatch/zipball/dfe1481c12c06266d0c3d58c0cb4b09bd497ab9c
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/XaZ7xB /usr/bin/composer install --prefer-dist --no-progress (http block)
• https://api.github.com/repos/symfony/string/zipball/73e2c6966a5aef1d4892873ed5322245295370c6
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/theofidry/cpu-core-counter/zipball/8520451a140d3f46ac33042715115e290cf5785f
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)
• https://api.github.com/repos/webmozarts/assert/zipball/11cb2199493b2f8a3b53e7f19068fc6aac760991
  • Triggering command: /usr/bin/php8.3 -n -c /tmp/PazsNi /usr/bin/composer install --no-interaction (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Factory is deprecated, but the link to the documentation still shows Factory:: calls</issue_title>
<issue_description>The main README links to https://alexdebril.github.io/feed-io/ with the text "Read the full documentation" but that same README also says that the Factory method has been removed:

The factory has been deprecated in feed-io 5.2 and was removed in 6.0. Instantiate the facade directly and pass in the desired HTTP client and logger interface.

Is there a current link for current usage? I can't make out what the correct syntax is, or was, or will be in the future.
</issue_description>

<agent_instructions>Check the documentation and make sure no links lead to the old repo.

Also suggest updates to the current documentation.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

• Fixes Factory is deprecated, but the link to the documentation still shows Factory:: calls #28

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.