Skip to content

Removed more references to third party docs #1

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 0 additions & 6 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,8 +1,2 @@
/_build
/bundles/DoctrineFixturesBundle
/bundles/DoctrineMigrationsBundle
/bundles/DoctrineMongoDBBundle
/bundles/SensioFrameworkExtraBundle
/bundles/SensioGeneratorBundle
/cmf
/_exts
6 changes: 3 additions & 3 deletions book/controller.rst
Original file line number Diff line number Diff line change
Expand Up @@ -552,9 +552,7 @@ The Symfony templating engine is explained in great detail in the
.. tip::

You can even avoid calling the ``render`` method by using the ``@Template``
annotation. See the
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/view>`
more details.
annotation. See the `FrameworkExtraBundle documentation`_ more details.

.. tip::

Expand Down Expand Up @@ -826,3 +824,5 @@ Learn more from the Cookbook

* :doc:`/cookbook/controller/error_pages`
* :doc:`/cookbook/controller/service`

.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html
Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should reference master everywhere here as there is no concept of "current" for third-party bundles.

Copy link
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nervermind.

25 changes: 14 additions & 11 deletions book/doctrine.rst
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ be.
easy, and explained in the ":doc:`/cookbook/doctrine/dbal`" cookbook entry.

You can also persist data to `MongoDB`_ using Doctrine ODM library. For
more information, read the ":doc:`/bundles/DoctrineMongoDBBundle/index`"
more information, read the "`DoctrineMongoDBBundle`_"
documentation.

A Simple Example: A Product
Expand Down Expand Up @@ -473,10 +473,10 @@ in your application. To do this, run:
new column to the existing ``product`` table.

An even better way to take advantage of this functionality is via
:doc:`migrations </bundles/DoctrineMigrationsBundle/index>`, which allow you to
generate these SQL statements and store them in migration classes that
can be run systematically on your production server in order to track
and migrate your database schema safely and reliably.
`migrations`_, which allow you to generate these SQL statements and store
them in migration classes that can be run systematically on your production
server in order to track and migrate your database schema safely and
reliably.

Your database now has a fully-functional ``product`` table with columns that
match the metadata you've specified.
Expand Down Expand Up @@ -562,7 +562,7 @@ an ``UPDATE`` query if the record already exists in the database.

Doctrine provides a library that allows you to programmatically load testing
data into your project (i.e. "fixture data"). For information, see
:doc:`/bundles/DoctrineFixturesBundle/index`.
the "`DoctrineFixturesBundle`_" documentation.

Fetching Objects from the Database
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand All @@ -589,8 +589,7 @@ on its ``id`` value::
.. tip::

You can achieve the equivalent of this without writing any code by using
the ``@ParamConverter`` shortcut. See the
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/converters>`
the ``@ParamConverter`` shortcut. See the `FrameworkExtraBundle documentation`_
for more details.

When you query for a particular type of object, you always use what's known
Expand Down Expand Up @@ -1084,7 +1083,7 @@ table, and ``product.category_id`` column, and new foreign key:

This task should only be really used during development. For a more robust
method of systematically updating your production database, read about
:doc:`Doctrine migrations </bundles/DoctrineMigrationsBundle/index>`.
`migrations`_.

Saving Related Entities
~~~~~~~~~~~~~~~~~~~~~~~
Expand Down Expand Up @@ -1400,8 +1399,8 @@ For more information about Doctrine, see the *Doctrine* section of the

* :doc:`/cookbook/doctrine/common_extensions`
* :doc:`/cookbook/doctrine/console`
* :doc:`/bundles/DoctrineFixturesBundle/index`
* :doc:`/bundles/DoctrineMongoDBBundle/index`
* :doc:`DoctrineFixturesBundle`
* :doc:`DoctrineMongoDBBundle`

.. _`Doctrine`: http://www.doctrine-project.org/
.. _`MongoDB`: http://www.mongodb.org/
Expand All @@ -1414,3 +1413,7 @@ For more information about Doctrine, see the *Doctrine* section of the
.. _`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
.. _`DoctrineMongoDBBundle`: http://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
.. _`migrations`: http://symfony.com/doc/current/bundles/DoctrineMigrationsBundle/index.html
.. _`DoctrineFixturesBundle`: http://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
4 changes: 2 additions & 2 deletions book/routing.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1070,8 +1070,7 @@ from the new routing resource.
.. tip::

You can also define routes using annotations. See the
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/routing>`
to see how.
`FrameworkExtraBundle documentation`_ to see how.

Adding a Host Requirement to Imported Routes
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down Expand Up @@ -1298,3 +1297,4 @@ Learn more from the Cookbook
* :doc:`/cookbook/routing/scheme`

.. _`FOSJsRoutingBundle`: https://github.com/FriendsOfSymfony/FOSJsRoutingBundle
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/routing.html
34 changes: 17 additions & 17 deletions components/http_kernel/introduction.rst
Original file line number Diff line number Diff line change
Expand Up @@ -288,16 +288,15 @@ on the event object that's passed to listeners on this event.
the Symfony Framework, and many deal with collecting profiler data when
the profiler is enabled.

One interesting listener comes from the :doc:`SensioFrameworkExtraBundle </bundles/SensioFrameworkExtraBundle/index>`,
One interesting listener comes from the `SensioFrameworkExtraBundle`_,
which is packaged with the Symfony Standard Edition. This listener's
:doc:`@ParamConverter </bundles/SensioFrameworkExtraBundle/annotations/converters>`
functionality allows you to pass a full object (e.g. a ``Post`` object)
to your controller instead of a scalar value (e.g. an ``id`` parameter
that was on your route). The listener - ``ParamConverterListener`` - uses
reflection to look at each of the arguments of the controller and tries
to use different methods to convert those to objects, which are then
stored in the ``attributes`` property of the ``Request`` object. Read the
next section to see why this is important.
`@ParamConverter`_ functionality allows you to pass a full object (e.g. a
``Post`` object) to your controller instead of a scalar value (e.g. an
``id`` parameter that was on your route). The listener -
``ParamConverterListener`` - uses reflection to look at each of the
arguments of the controller and tries to use different methods to convert
those to objects, which are then stored in the ``attributes`` property of
the ``Request`` object. Read the next section to see why this is important.

4) Getting the Controller Arguments
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Expand Down Expand Up @@ -395,14 +394,12 @@ return a ``Response``.
.. sidebar:: ``kernel.view`` in the Symfony Framework

There is no default listener inside the Symfony Framework for the ``kernel.view``
event. However, one core bundle -
:doc:`SensioFrameworkExtraBundle </bundles/SensioFrameworkExtraBundle/index>` -
*does* add a listener to this event. If your controller returns an array,
and you place the :doc:`@Template </bundles/SensioFrameworkExtraBundle/annotations/view>`
annotation above the controller, then this listener renders a template,
passes the array you returned from your controller to that template,
and creates a ``Response`` containing the returned content from that
template.
event. However, one core bundle - `SensioFrameworkExtraBundle`_ - *does*
add a listener to this event. If your controller returns an array,
and you place the `@Template`_ annotation above the controller, then this
listener renders a template, passes the array you returned from your
controller to that template, and creates a ``Response`` containing the
returned content from that template.

Additionally, a popular community bundle `FOSRestBundle`_ implements
a listener on this event which aims to give you a robust view layer
Expand Down Expand Up @@ -689,3 +686,6 @@ look like this::
.. _reflection: http://php.net/manual/en/book.reflection.php
.. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle
.. _`Create your own framework... on top of the Symfony2 Components`: http://fabien.potencier.org/article/50/create-your-own-framework-on-top-of-the-symfony2-components-part-1
.. _`SensioFrameworkExtraBundle`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
.. _`@ParamConverter`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
.. _`@Template`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html
6 changes: 3 additions & 3 deletions cookbook/controller/service.rst
Original file line number Diff line number Diff line change
Expand Up @@ -132,9 +132,8 @@ the route ``_controller`` value:
.. tip::

You can also use annotations to configure routing using a controller
defined as a service. See the
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/routing>`
for details.
defined as a service. See the `FrameworkExtraBundle documentation`_ for
details.

Alternatives to base Controller Methods
---------------------------------------
Expand Down Expand Up @@ -267,3 +266,4 @@ inject *only* the exact service(s) that you need directly into the controller.

.. _`Controller class source code`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php
.. _`base Controller class`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/routing.html
7 changes: 4 additions & 3 deletions cookbook/templating/PHP.rst
Original file line number Diff line number Diff line change
Expand Up @@ -60,11 +60,10 @@ below renders the ``index.html.php`` template::
);
}

You can also use the :doc:`/bundles/SensioFrameworkExtraBundle/annotations/view`
shortcut to render the default ``AcmeHelloBundle:Hello:index.html.php`` template::
You can also use the `@Template`_ shortcut to render the default
``AcmeHelloBundle:Hello:index.html.php`` template::

// src/Acme/HelloBundle/Controller/HelloController.php

use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;

// ...
Expand Down Expand Up @@ -326,3 +325,5 @@ within an HTML context. The second argument lets you change the context. For
instance, to output something in a JavaScript script, use the ``js`` context::

<?php echo $view->escape($var, 'js') ?>

.. _`@Template`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view`