use the doc role for internal links

best_practices/business-logic.rst

@@ -326,9 +326,9 @@ Coding Standards
 
 The Symfony source code follows the `PSR-1`_ and `PSR-2`_ coding standards that
 were defined by the PHP community. You can learn more about
-:doc:`/contributing/code/standards` and even 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.
+:doc:`the Symfony Coding standards </contributing/code/standards>` and even
+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
 .. _`Doctrine project`: http://www.doctrine-project.org/

best_practices/security.rst

@@ -267,9 +267,5 @@ If your company uses a user login method not supported by Symfony, you can
 develop :doc:`your own user provider </cookbook/security/custom_provider>` and
 :doc:`your own authentication provider </cookbook/security/custom_authentication_provider>`.
 
-.. _`Security Cookbook Section`: http://symfony.com/doc/current/cookbook/security/index.html
-.. _`security.yml`: http://symfony.com/doc/current/reference/configuration/security.html
 .. _`@Security annotation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/security.html
-.. _`security voter`: http://symfony.com/doc/current/cookbook/security/voters_data_permission.html
-.. _`ACL's`: http://symfony.com/doc/current/cookbook/security/acl.html
 .. _`FOSUserBundle`: https://github.com/FriendsOfSymfony/FOSUserBundle

book/installation.rst

@@ -98,8 +98,9 @@ number as the second argument of the ``new`` command:
     # Windows
     c:\projects\> php symfony.phar new my_project_name 2.3.23
 
-Read the `Symfony Release process`_ to better understand why there are several
-Symfony versions and which one to use for your projects.
+Read the :doc:`Symfony Release process </contributing/community/releases>`
+to better understand why there are several Symfony versions and which one
+to use for your projects.
 
 .. _book-creating-applications-without-the-installer:
 
@@ -375,7 +376,6 @@ a wide variety of articles about solving specific problems with Symfony.
     If you want to remove the sample code from your distribution, take a look
     at this cookbook article: ":doc:`/cookbook/bundles/remove`"
 
-.. _`Symfony Release process`: http://symfony.com/doc/current/contributing/community/releases.html
 .. _`explained in this post`: http://fabien.potencier.org/article/73/signing-project-releases
 .. _`Composer`: http://getcomposer.org/
 .. _`Composer download page`: https://getcomposer.org/download/

contributing/code/bugs.rst

@@ -11,7 +11,7 @@ us make a better Symfony.
 
 Before submitting a bug:
 
-* Double-check the official `documentation`_ to see if you're not misusing the
+* Double-check the official :doc:`documentation </index>` to see if you're not misusing the
   framework;
 
 * Ask for assistance on the `users mailing-list`_, the `forum`_, or on the
@@ -34,7 +34,6 @@ If your problem definitely looks like a bug, report it using the official bug
 
 * *(optional)* Attach a :doc:`patch <patches>`.
 
-.. _documentation: http://symfony.com/doc/current/
 .. _users mailing-list: http://groups.google.com/group/symfony2
 .. _forum: http://forum.symfony-project.org/
 .. _IRC channel: irc://irc.freenode.net/symfony

cookbook/workflow/new_project_git.rst

@@ -95,7 +95,6 @@ manage this is `Gitolite`_.
 
 .. _`Git`: http://git-scm.com/
 .. _`Symfony Standard Edition`: http://symfony.com/download
-.. _`Installing Symfony using Composer`: http://symfony.com/doc/current/book/installation.html#option-1-composer
 .. _`git submodules`: http://git-scm.com/book/en/Git-Tools-Submodules
 .. _`GitHub`: https://github.com/
 .. _`barebones repository`: http://git-scm.com/book/en/Git-Basics-Getting-a-Git-Repository

quick_tour/the_big_picture.rst

@@ -237,7 +237,7 @@ of the ``Default`` controller when the user browses the ``/`` path of the applic
 .. tip::
 
     In addition to PHP annotations, routes can be configured in YAML, XML or
-    PHP files, as explained in `the Routing chapter of the Symfony book`_ .
+    PHP files, as explained in :doc:`the Routing chapter of the Symfony book </book/routing>`.
     This flexibility is one of the main features of Symfony, a framework that
     never imposes a particular configuration format on you.
 
@@ -359,4 +359,3 @@ are eager to learn more about Symfony, dive into the next section:
 .. _Composer: https://getcomposer.org/
 .. _executable installer: http://getcomposer.org/download
 .. _Twig: http://twig.sensiolabs.org/
-.. _the Routing chapter of the Symfony book: http://symfony.com/doc/current/book/routing.html