Merge branch '2.8'

gregfriedrice · Sep 1, 2015 · 7c926c6 · 7c926c6
2 parents 3a4e8ca + d86bec8
commit 7c926c6
Show file tree

Hide file tree

Showing 74 changed files with 195 additions and 155 deletions.
diff --git a/best_practices/business-logic.rst b/best_practices/business-logic.rst
@@ -333,7 +333,7 @@ were defined by the PHP community. You can learn more about
 use the `PHP-CS-Fixer`_, which is a command-line utility that can fix the
 coding standards of an entire codebase in a matter of seconds.
 
-.. _`full definition`: http://en.wikipedia.org/wiki/Business_logic
+.. _`full definition`: https://en.wikipedia.org/wiki/Business_logic
 .. _`Doctrine project`: http://www.doctrine-project.org/
 .. _`fixture class`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html#writing-simple-fixtures
 .. _`PSR-1`: http://www.php-fig.org/psr/psr-1/

diff --git a/best_practices/configuration.rst b/best_practices/configuration.rst
@@ -180,5 +180,5 @@ that you store them outside the Symfony project and make them available
 through environment variables. Learn how to do it in the following article:
 :doc:`/cookbook/configuration/external_parameters`
 
-.. _`feature toggles`: http://en.wikipedia.org/wiki/Feature_toggle
+.. _`feature toggles`: https://en.wikipedia.org/wiki/Feature_toggle
 .. _`constant() function`: http://twig.sensiolabs.org/doc/functions/constant.html
diff --git a/best_practices/creating-the-project.rst b/best_practices/creating-the-project.rst
@@ -177,4 +177,4 @@ the Symfony directory structure.
 .. _`Get Started`: https://getcomposer.org/doc/00-intro.md
 .. _`Composer download page`: https://getcomposer.org/download/
 .. _`public checksums repository`: https://github.com/sensiolabs/checksums
-.. _`these steps`: http://fabien.potencier.org/article/73/signing-project-releases
+.. _`these steps`: http://fabien.potencier.org/signing-project-releases.html
diff --git a/best_practices/tests.rst b/best_practices/tests.rst
@@ -121,4 +121,4 @@ for your test fixtures.
 .. _`PhpUnit`: https://phpunit.de/
 .. _`PhpSpec`: http://www.phpspec.net/
 .. _`Mink`: http://mink.behat.org
-.. _`smoke testing`: http://en.wikipedia.org/wiki/Smoke_testing_(software)
+.. _`smoke testing`: https://en.wikipedia.org/wiki/Smoke_testing_(software)
diff --git a/book/doctrine.rst b/book/doctrine.rst
@@ -362,7 +362,7 @@ see the :ref:`book-doctrine-field-types` section.
     `Reserved SQL keywords documentation`_ on how to properly escape these
     names. Alternatively, if you're free to choose your database schema,
     simply map to a different table name or column name. See Doctrine's
-    `Persistent classes`_ and `Property Mapping`_ documentation.
+    `Creating Classes for the Database`_ and `Property Mapping`_ documentation.
 
 .. note::
 
@@ -1421,7 +1421,7 @@ For more information about Doctrine, see the *Doctrine* section of the
 * `DoctrineMongoDBBundle`_
 
 .. _`Doctrine`: http://www.doctrine-project.org/
-.. _`MongoDB`: http://www.mongodb.org/
+.. _`MongoDB`: https://www.mongodb.org/
 .. _`Basic Mapping Documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html
 .. _`Query Builder`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/query-builder.html
 .. _`Doctrine Query Language`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/dql-doctrine-query-language.html
@@ -1430,7 +1430,7 @@ For more information about Doctrine, see the *Doctrine* section of the
 .. _`Property Mapping`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#property-mapping
 .. _`Lifecycle Events documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#lifecycle-events
 .. _`Reserved SQL keywords documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#quoting-reserved-words
-.. _`Persistent classes`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#persistent-classes
+.. _`Creating Classes for the Database`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#creating-classes-for-the-database
 .. _`DoctrineMongoDBBundle`: https://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
 .. _`migrations`: https://symfony.com/doc/current/bundles/DoctrineMigrationsBundle/index.html
 .. _`DoctrineFixturesBundle`: https://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html

diff --git a/book/from_flat_php_to_symfony2.rst b/book/from_flat_php_to_symfony2.rst
@@ -320,6 +320,8 @@ As it stands now, that code would need to be added to every controller file.
 If you forget to include something in one file, hopefully it doesn't relate
 to security...
 
+.. _book-from_flat_php-front-controller:
+
 A "Front Controller" to the Rescue
 ----------------------------------
 

diff --git a/book/http_cache.rst b/book/http_cache.rst
@@ -627,7 +627,7 @@ doing so much work.
 
     Symfony also supports weak ETags by passing ``true`` as the second
     argument to the
-    :method:`Symfony\\Component\\HttpFoundation\\Response::setETag` method.
+    :method:`Symfony\\Component\\HttpFoundation\\Response::setEtag` method.
 
 .. index::
    single: Cache; Last-Modified header
@@ -1244,7 +1244,7 @@ Learn more from the Cookbook
 
 * :doc:`/cookbook/cache/varnish`
 
-.. _`Things Caches Do`: http://tomayko.com/writings/things-caches-do
+.. _`Things Caches Do`: http://2ndscale.com/writings/things-caches-do
 .. _`Cache Tutorial`: http://www.mnot.net/cache_docs/
 .. _`Varnish`: https://www.varnish-cache.org/
 .. _`Squid in reverse proxy mode`: http://wiki.squid-cache.org/SquidFaq/ReverseProxy

diff --git a/book/http_fundamentals.rst b/book/http_fundamentals.rst
@@ -576,8 +576,8 @@ sensible defaults. For more advanced users, the sky is the limit.
 .. _`HTTP 1.1 RFC`: http://www.w3.org/Protocols/rfc2616/rfc2616.html
 .. _`HTTP Bis`: http://datatracker.ietf.org/wg/httpbis/
 .. _`Live HTTP Headers`: https://addons.mozilla.org/en-US/firefox/addon/live-http-headers/
-.. _`List of HTTP status codes`: http://en.wikipedia.org/wiki/List_of_HTTP_status_codes
-.. _`List of HTTP header fields`: http://en.wikipedia.org/wiki/List_of_HTTP_header_fields
-.. _`List of common media types`: http://en.wikipedia.org/wiki/Internet_media_type#List_of_common_media_types
+.. _`List of HTTP status codes`: https://en.wikipedia.org/wiki/List_of_HTTP_status_codes
+.. _`List of HTTP header fields`: https://en.wikipedia.org/wiki/List_of_HTTP_header_fields
+.. _`List of common media types`: https://www.iana.org/assignments/media-types/media-types.xhtml
 .. _`Validator`: https://github.com/symfony/Validator
 .. _`Swift Mailer`: http://swiftmailer.org/
diff --git a/book/installation.rst b/book/installation.rst
@@ -406,7 +406,7 @@ need in your new application.
 Be sure to also check out the :doc:`Cookbook </cookbook/index>`, which contains
 a wide variety of articles about solving specific problems with Symfony.
 
-.. _`explained in this post`: http://fabien.potencier.org/article/73/signing-project-releases
+.. _`explained in this post`: http://fabien.potencier.org/signing-project-releases.html
 .. _`Composer`: https://getcomposer.org/
 .. _`Composer download page`: https://getcomposer.org/download/
 .. _`Apache`: http://httpd.apache.org/docs/current/mod/core.html#documentroot

diff --git a/book/performance.rst b/book/performance.rst
@@ -139,8 +139,8 @@ file since there will be fewer files to monitor for changes. Of course if this
 feature is disabled in the byte code cache (e.g. ``apc.stat=0`` in APC), there
 is no longer a reason to use a bootstrap file.
 
-.. _`byte code caches`: http://en.wikipedia.org/wiki/List_of_PHP_accelerators
+.. _`byte code caches`: https://en.wikipedia.org/wiki/List_of_PHP_accelerators
 .. _`OPcache`: http://php.net/manual/en/book.opcache.php
 .. _`APC`: http://php.net/manual/en/book.apc.php
 .. _`autoload.php`: https://github.com/symfony/symfony-standard/blob/master/app/autoload.php
-.. _`bootstrap file`: https://github.com/sensio/SensioDistributionBundle/blob/master/Composer/ScriptHandler.php
+.. _`bootstrap file`: https://github.com/sensiolabs/SensioDistributionBundle/blob/master/Composer/ScriptHandler.php
diff --git a/book/service_container.rst b/book/service_container.rst
@@ -1184,4 +1184,4 @@ Learn more
 * :doc:`/cookbook/service_container/compiler_passes`
 * :doc:`/components/dependency_injection/advanced`
 
-.. _`service-oriented architecture`: http://wikipedia.org/wiki/Service-oriented_architecture
+.. _`service-oriented architecture`: https://en.wikipedia.org/wiki/Service-oriented_architecture
diff --git a/book/templating.rst b/book/templating.rst
@@ -1014,9 +1014,9 @@ but Symfony provides a more dynamic option via the ``asset`` Twig function:
         <link href="<?php echo $view['assets']->getUrl('css/blog.css') ?>" rel="stylesheet" />
 
 The ``asset`` function's main purpose is to make your application more portable.
-If your application lives at the root of your host (e.g. http://example.com),
+If your application lives at the root of your host (e.g. ``http://example.com``),
 then the rendered paths should be ``/images/logo.png``. But if your application
-lives in a subdirectory (e.g. http://example.com/my_app), each asset path
+lives in a subdirectory (e.g. ``http://example.com/my_app``), each asset path
 should render with the subdirectory (e.g. ``/my_app/images/logo.png``). The
 ``asset`` function takes care of this by determining how your application is
 being used and generating the correct paths accordingly.
@@ -1697,12 +1697,12 @@ Learn more from the Cookbook
 
 .. _`Twig`: http://twig.sensiolabs.org
 .. _`KnpBundles.com`: http://knpbundles.com
-.. _`Cross Site Scripting`: http://en.wikipedia.org/wiki/Cross-site_scripting
+.. _`Cross Site Scripting`: https://en.wikipedia.org/wiki/Cross-site_scripting
 .. _`Output Escaping`: http://twig.sensiolabs.org/doc/api.html#escaper-extension
 .. _`tags`: http://twig.sensiolabs.org/doc/tags/index.html
 .. _`filters`: http://twig.sensiolabs.org/doc/filters/index.html
 .. _`add your own extensions`: http://twig.sensiolabs.org/doc/advanced.html#creating-an-extension
-.. _`hinclude.js`: http://mnot.github.com/hinclude/
+.. _`hinclude.js`: http://mnot.github.io/hinclude/
 .. _`with_context`: http://twig.sensiolabs.org/doc/functions/include.html
 .. _`include() function`: http://twig.sensiolabs.org/doc/functions/include.html
 .. _`{% include %} tag`: http://twig.sensiolabs.org/doc/tags/include.html
diff --git a/book/testing.rst b/book/testing.rst
@@ -881,4 +881,4 @@ Learn more
 * :doc:`/cookbook/testing/bootstrap`
 
 .. _`$_SERVER`: http://php.net/manual/en/reserved.variables.server.php
-.. _`documentation`: http://phpunit.de/manual/current/en/
+.. _`documentation`: https://phpunit.de/manual/current/en/
diff --git a/book/translation.rst b/book/translation.rst
@@ -885,8 +885,8 @@ steps:
 * Manage the user's locale, which is stored on the request, but can also
   be set on the user's session.
 
-.. _`i18n`: http://en.wikipedia.org/wiki/Internationalization_and_localization
-.. _`ISO 3166-1 alpha-2`: http://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
-.. _`ISO 639-1`: http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+.. _`i18n`: https://en.wikipedia.org/wiki/Internationalization_and_localization
+.. _`ISO 3166-1 alpha-2`: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes
+.. _`ISO 639-1`: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
 .. _`Translatable Extension`: https://github.com/l3pp4rd/DoctrineExtensions
 .. _`Translatable Behavior`: https://github.com/KnpLabs/DoctrineBehaviors
diff --git a/changelog.rst b/changelog.rst
@@ -13,6 +13,58 @@ documentation.
     Do you also want to participate in the Symfony Documentation? Take a look
     at the ":doc:`/contributing/documentation/overview`" article.
 
+August, 2015
+------------
+
+New Documentation
+~~~~~~~~~~~~~~~~~
+
+* `#5480 <https://github.com/symfony/symfony-docs/pull/5480>`_ Added page "Community Reviews" (webmozart)
+* `#5595 <https://github.com/symfony/symfony-docs/pull/5595>`_ Improve humanize filter documentation (bocharsky-bw)
+* `#5319 <https://github.com/symfony/symfony-docs/pull/5319>`_ [Console] Command Lifecycle explications (94noni)
+* `#5394 <https://github.com/symfony/symfony-docs/pull/5394>`_ Fix Major upgrade article for 2.7.1 changes (WouterJ)
+
+Fixed Documentation
+~~~~~~~~~~~~~~~~~~~
+
+* `#5589 <https://github.com/symfony/symfony-docs/pull/5589>`_ [Cookbook][Session] fix default expiry field name (xabbuh)
+* `#5607 <https://github.com/symfony/symfony-docs/pull/5607>`_ Fix (sebastianbergmann)
+* `#5608 <https://github.com/symfony/symfony-docs/pull/5608>`_ updated validation.rst (issei-m)
+* `#5449 <https://github.com/symfony/symfony-docs/pull/5449>`_ Ensure that the entity is updated. (yceruto)
+
+Minor Documentation Changes
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+* `#5553 <https://github.com/symfony/symfony-docs/pull/5553>`_ Fix all broken links/permanent redirects/removed anchors (WouterJ)
+* `#5650 <https://github.com/symfony/symfony-docs/pull/5650>`_ [RFR] fixing typo and removing duplicated lines in Config component doc  (salahm)
+* `#5635 <https://github.com/symfony/symfony-docs/pull/5635>`_ Fix minor problems in book/page_creation.rst (fabschurt)
+* `#5647 <https://github.com/symfony/symfony-docs/pull/5647>`_ don't ignore the _exts directory anymore (xabbuh)
+* `#5587 <https://github.com/symfony/symfony-docs/pull/5587>`_ [2.6] Don't use deprecated features (WouterJ)
+* `#5637 <https://github.com/symfony/symfony-docs/pull/5637>`_ Add QueryBuilder vs DQL section (bocharsky-bw)
+* `#5645 <https://github.com/symfony/symfony-docs/pull/5645>`_ Updated Constraint reference with best practices (WouterJ)
+* `#5646 <https://github.com/symfony/symfony-docs/pull/5646>`_ Moved comment to the right place (mickaelandrieu)
+* `#5649 <https://github.com/symfony/symfony-docs/pull/5649>`_ [RFR] Fixing typo in Symfony version for ButtonType (salahm)
+* `#5606 <https://github.com/symfony/symfony-docs/pull/5606>`_ Use symfony.com theme on Platform.sh builds (WouterJ)
+* `#5644 <https://github.com/symfony/symfony-docs/pull/5644>`_ Update page_creation.rst (jeromenadaud)
+* `#5593 <https://github.com/symfony/symfony-docs/pull/5593>`_ Updated the profiler matchers article (javiereguiluz)
+* `#5522 <https://github.com/symfony/symfony-docs/pull/5522>`_ [create_framework] Add missing extract() 2nd arg (kenjis)
+* `#5597 <https://github.com/symfony/symfony-docs/pull/5597>`_ [CreateFramework] don't override existing variables (xabbuh)
+* `#5628 <https://github.com/symfony/symfony-docs/pull/5628>`_ Updated the installation chapter (javiereguiluz)
+* `#5638 <https://github.com/symfony/symfony-docs/pull/5638>`_ Update page_creation.rst (jeromenadaud)
+* `#5636 <https://github.com/symfony/symfony-docs/pull/5636>`_ Fixed typo in web-assets.rst (nielsvermaut)
+* `#5633 <https://github.com/symfony/symfony-docs/pull/5633>`_ Upgrade Platform.sh configuration snippet. (GuGuss)
+* `#5620 <https://github.com/symfony/symfony-docs/pull/5620>`_ Changed the recommendation about the LICENSE file for third-party bundles (javiereguiluz)
+* `#5617 <https://github.com/symfony/symfony-docs/pull/5617>`_ Add Body tag to see the web debug toolbar (rmed19)
+* `#5594 <https://github.com/symfony/symfony-docs/pull/5594>`_ Missing --no-interaction flag? (alexwybraniec)
+* `#5613 <https://github.com/symfony/symfony-docs/pull/5613>`_ Remove unneeded backtick (fabschurt)
+* `#5622 <https://github.com/symfony/symfony-docs/pull/5622>`_ typo fix in pre authenticated (Maxime Douailin)
+* `#5624 <https://github.com/symfony/symfony-docs/pull/5624>`_ the_architecture: Fix syntax error (kainjow)
+* `#5609 <https://github.com/symfony/symfony-docs/pull/5609>`_ Add a missing backtick (fabschurt)
+* `#5312 <https://github.com/symfony/symfony-docs/pull/5312>`_ Some fixes for bundle best practices (WouterJ)
+* `#5601 <https://github.com/symfony/symfony-docs/pull/5601>`_ Update lazy_services.rst (baziak3)
+* `#5591 <https://github.com/symfony/symfony-docs/pull/5591>`_ Update templating.rst: lint:twig instead of twig:lint in 2.7 (alexwybraniec)
+
+
 July, 2015
 ----------
 

diff --git a/components/config/definition.rst b/components/config/definition.rst
@@ -115,9 +115,9 @@ Numeric Node Constraints
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
 Numeric nodes (float and integer) provide two extra constraints -
-:method:`Symfony\\Component\\Config\\Definition\\Builder::min` and
-:method:`Symfony\\Component\\Config\\Definition\\Builder::max` -
-allowing to validate the value::
+:method:`Symfony\\Component\\Config\\Definition\\Builder\\IntegerNodeDefinition::min`
+and :method:`Symfony\\Component\\Config\\Definition\\Builder\\IntegerNodeDefinition::max`
+- allowing to validate the value::
 
     $rootNode
         ->children()

diff --git a/components/dependency_injection/lazy_services.rst b/components/dependency_injection/lazy_services.rst
@@ -115,5 +115,5 @@ in the `documentation of ProxyManager`_.
 
 
 .. _`ProxyManager bridge`: https://github.com/symfony/symfony/tree/master/src/Symfony/Bridge/ProxyManager
-.. _`proxy`: http://en.wikipedia.org/wiki/Proxy_pattern
+.. _`proxy`: https://en.wikipedia.org/wiki/Proxy_pattern
 .. _`documentation of ProxyManager`: https://github.com/Ocramius/ProxyManager/blob/master/docs/lazy-loading-value-holder.md
diff --git a/components/dom_crawler.rst b/components/dom_crawler.rst
@@ -255,7 +255,7 @@ The crawler supports multiple ways of adding the content::
 .. note::
 
     When dealing with character sets other than ISO-8859-1, always add HTML
-    content using the :method:`Symfony\\Component\\DomCrawler\\Crawler::addHTMLContent`
+    content using the :method:`Symfony\\Component\\DomCrawler\\Crawler::addHtmlContent`
     method where you can specify the second parameter to be your target character
     set.
 
@@ -472,5 +472,5 @@ the whole form or specific field(s)::
     $form->disableValidation();
     $form['country']->select('Invalid value');
 
-.. _`Goutte`:  https://github.com/fabpot/goutte
+.. _`Goutte`: https://github.com/FriendsOfPHP/Goutte
 .. _Packagist: https://packagist.org/packages/symfony/dom-crawler
diff --git a/components/event_dispatcher/introduction.rst b/components/event_dispatcher/introduction.rst
@@ -655,7 +655,7 @@ with 2 other dispatchers:
 * :doc:`/components/event_dispatcher/container_aware_dispatcher`
 * :doc:`/components/event_dispatcher/immutable_dispatcher`
 
-.. _Mediator: http://en.wikipedia.org/wiki/Mediator_pattern
+.. _Mediator: https://en.wikipedia.org/wiki/Mediator_pattern
 .. _Closures: http://php.net/manual/en/functions.anonymous.php
 .. _PHP callable: http://www.php.net/manual/en/language.pseudo-types.php#language.types.callback
 .. _Packagist: https://packagist.org/packages/symfony/event-dispatcher
diff --git a/components/form/introduction.rst b/components/form/introduction.rst
@@ -63,7 +63,7 @@ factory.
 
 .. tip::
 
-    For a working example, see https://github.com/bschussek/standalone-forms
+    For a working example, see https://github.com/webmozart/standalone-forms
 
 Request Handling
 ~~~~~~~~~~~~~~~~
@@ -700,5 +700,5 @@ method to access the list of errors. It returns a
     on the form errors.
 
 .. _Packagist: https://packagist.org/packages/symfony/form
-.. _Twig:      http://twig.sensiolabs.org
+.. _Twig: http://twig.sensiolabs.org
 .. _`Twig Configuration`: http://twig.sensiolabs.org/doc/intro.html
diff --git a/components/http_foundation/session_testing.rst b/components/http_foundation/session_testing.rst
@@ -21,16 +21,16 @@ The mock storage drivers do not read or write the system globals
 ``session_id()`` or ``session_name()``. Methods are provided to simulate this if
 required:
 
-* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionStorageInterface::getId`: Gets the
+* :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface::getId`: Gets the
   session ID.
 
-* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionStorageInterface::setId`: Sets the
+* :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface::setId`: Sets the
   session ID.
 
-* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionStorageInterface::getName`: Gets the
+* :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface::getName`: Gets the
   session name.
 
-* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionStorageInterface::setName`: Sets the
+* :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\SessionStorageInterface::setName`: Sets the
   session name.
 
 Unit Testing

diff --git a/components/http_foundation/sessions.rst b/components/http_foundation/sessions.rst
@@ -226,9 +226,6 @@ has a simple API
 :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::has`
     Returns true if the attribute exists.
 
-:method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::keys`
-    Returns an array of stored attribute keys.
-
 :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::replace`
     Sets multiple attributes at once: takes a keyed array and sets each key => value pair.
 

diff --git a/components/http_kernel/introduction.rst b/components/http_kernel/introduction.rst
@@ -118,11 +118,11 @@ See ":ref:`http-kernel-working-example`" for a more concrete implementation.
 For general information on adding listeners to the events below, see
 :ref:`http-kernel-creating-listener`.
 
-.. tip::
+.. seealso::
 
-    Fabien Potencier also wrote a wonderful series on using the HttpKernel
-    component and other Symfony components to create your own framework. See
-    `Create your own framework... on top of the Symfony2 Components`_.
+    There is a wonderful tutorial series on using the HttpKernel component and
+    other Symfony components to create your own framework. See
+    :doc:`/create_framework/introduction`.
 
 .. _component-http-kernel-kernel-request: