diff --git a/book/index.rst b/book/index.rst index 915b0fc7a7f..185f7ccb88f 100644 --- a/book/index.rst +++ b/book/index.rst @@ -22,6 +22,5 @@ The Book service_container performance internals - stable_api .. include:: /book/map.rst.inc diff --git a/book/map.rst.inc b/book/map.rst.inc index 573c8027524..0a1b3381c09 100644 --- a/book/map.rst.inc +++ b/book/map.rst.inc @@ -16,4 +16,3 @@ * :doc:`/book/service_container` * :doc:`/book/performance` * :doc:`/book/internals` -* :doc:`/book/stable_api` diff --git a/book/stable_api.rst b/book/stable_api.rst deleted file mode 100644 index 73ced34d6ea..00000000000 --- a/book/stable_api.rst +++ /dev/null @@ -1,55 +0,0 @@ -.. index:: - single: Stable API - -.. _the-symfony2-stable-api: - -The Symfony Stable API -====================== - -The Symfony stable API is a subset of all Symfony published public methods -(components and core bundles) that share the following properties: - -* The namespace and class name won't change; -* The method name won't change; -* The method signature (arguments and return value type) won't change; -* The semantic of what the method does won't change. - -The implementation itself can change though. The only valid case for a change -in the stable API is in order to fix a security issue. - -The stable API is based on a whitelist, tagged with `@api`. Therefore, -everything not tagged explicitly is not part of the stable API. - -.. seealso:: - - You can browse the Symfony API documentation on `api.symfony.com`_. - -.. tip:: - - Read more about the stable API in :doc:`/contributing/code/bc`. - -.. tip:: - - Any third party bundle should also publish its own stable API. - -As of Symfony 2.0, the following components have a public tagged API: - -* BrowserKit -* ClassLoader -* Console -* CssSelector -* DependencyInjection -* DomCrawler -* EventDispatcher -* Filesystem (as of Symfony 2.1) -* Finder -* HttpFoundation -* HttpKernel -* Process -* Routing -* Templating -* Translation -* Validator -* Yaml - -.. _`api.symfony.com`: http://api.symfony.com diff --git a/redirection_map b/redirection_map index e632d829662..2d782f924fb 100644 --- a/redirection_map +++ b/redirection_map @@ -1,3 +1,4 @@ +/book/stable_api /contributing/code/bc /cookbook/deployment-tools /cookbook/deployment/tools /cookbook/doctrine/migrations /bundles/DoctrineFixturesBundle/index /cookbook/doctrine/doctrine_fixtures /bundles/DoctrineFixturesBundle/index