Tweaks

Author: javiereguiluz

bundles/best_practices.rst

@@ -22,10 +22,10 @@ interoperability standard for PHP namespaces and class names: it starts with a
 vendor segment, followed by zero or more category segments, and it ends with the
 namespace short name, which must end with ``Bundle``.
 
-A namespace becomes a bundle as soon as you add a bundle class to it. The
-bundle class name must follow these rules:
+A namespace becomes a bundle as soon as you add "a bundle class" to it (which is
+a class that extends :class:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle`).
+The bundle class name must follow these rules:
 
-* Extend Symfony\Component\HttpKernel\Bundle\Bundle
 * Use only alphanumeric characters and underscores;
 * Use a StudlyCaps name (i.e. camelCase with an uppercase first letter);
 * Use a descriptive and short name (no more than two words);
@@ -42,6 +42,9 @@ Namespace                   Bundle Class Name
 ``Acme\BlogBundle``         AcmeBlogBundle
 ==========================  ==================
 
+By convention, the ``getName()`` method of the bundle class should return the
+class name.
+
 .. note::
 
     If you share your bundle publicly, you must use the bundle class name as