add mention of symfony.com re folder structure

darrylhein · xabbuh · commit 57fcec0f313c · 2017-09-15T12:20:29.000+02:00
diff --git a/bundles/best_practices.rst b/bundles/best_practices.rst
@@ -185,7 +185,8 @@ Documentation
 All classes and functions must come with full PHPDoc.
 
 Extensive documentation should also be provided in the ``Resources/doc/`` 
-directory. The index file (for example ``Resources/doc/index.rst`` or 
+directory (though only required when the documentation is shown on symfony.com).
+The index file (for example ``Resources/doc/index.rst`` or 
 ``Resources/doc/index.md``) is the only mandatory file and must be the entry 
 point for the documentation. The 
 :doc:`reStructuredText (rST) </contributing/documentation/format>` is the most 
