Fixes and rewords

Author: javiereguiluz

best_practices.rst

@@ -1,16 +1,16 @@
 The Symfony Framework Best Practices
 ====================================
 
-The Symfony Framework is well-known for being *really* flexible and is used to
-build from micro-sites to enterprise applications. This guide describes the
-**best practices for developing web applications with Symfony** that fit the
-philosophy envisioned by the original Symfony creators. You should only read
-this guide if you already have experience developing Symfony applications.
+This article describes the **best practices for developing web applications with
+Symfony** that fit the philosophy envisioned by the original Symfony creators.
 
-If you don't agree with some of these recommendations, this guide might be a good
+If you don't agree with some of these recommendations, they might be a good
 **starting point** that you can then **extend and fit to your specific needs**.
-You can even ignore this guide completely and continue using your own best
-practices and methodologies. Symfony is flexible enough to adapt to your needs.
+You can even ignore them completely and continue using your own best practices
+and methodologies. Symfony is flexible enough to adapt to your needs.
+
+This article assumes that you already have experience developing Symfony
+applications. If you don't, read first the rest of the `Symfony documentation`_.
 
 .. tip::
 
@@ -457,13 +457,14 @@ Hardcode URLs in a Functional Test
 
 In Symfony applications it's recommended to :ref:`generate URLs <routing-generating-urls>`
 using routes to automatically update all links when a URL changes. However, if a
-URL changes, your public website will break unless you set up a redirection to
-the new URL.
+public URL changes, users won't be able to browse it unless you set up a
+redirection to the new URL.
 
 That's why it's recommended to use raw URLs in tests instead of generating them
 from routes. Whenever a route changes, tests will break and you'll know that
 you must set up a redirection.
 
+.. _`Symfony documentation`: https://symfony.com/doc
 .. _`Symfony Demo`: https://github.com/symfony/demo
 .. _`download Symfony`: https://symfony.com/download
 .. _`Composer`: https://getcomposer.org/

testing.rst

@@ -1054,7 +1054,6 @@ Learn more
     :glob:
 
     testing/*
-    /best_practices/tests
     /components/dom_crawler
     /components/css_selector