From e65f443b07a2b7fbd6fcbf19a3815e24173636c4 Mon Sep 17 00:00:00 2001 From: Ryan Weaver Date: Thu, 18 Sep 2014 10:26:19 -0400 Subject: [PATCH 1/2] Clarifying that the bundles best practices entry is for reusable bundles, not for app bundles --- cookbook/bundles/best_practices.rst | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/cookbook/bundles/best_practices.rst b/cookbook/bundles/best_practices.rst index 51465b9d15a..383bb3a8b01 100644 --- a/cookbook/bundles/best_practices.rst +++ b/cookbook/bundles/best_practices.rst @@ -1,12 +1,19 @@ .. index:: single: Bundle; Best practices -How to Use best Practices for Structuring Bundles -================================================= +Best Practices for Reusable Bundles +=================================== -A bundle is a directory that has a well-defined structure and can host anything -from classes to controllers and web resources. Even if bundles are very -flexible, you should follow some best practices if you want to distribute them. +There are 2 types of bundles: + +* Application bundles: only use to build your application; +* Reusable bundle: meant to be shared across many projects. + +This article is all about how to structure your **reusable bundles** so that +they're easy to configure and extend. Many of these recommendations do not +apply to application bundles because you'll want to keep those as simple +as possible. For application bundles, just follow the practices shown throughout +the book and cookbook. .. index:: pair: Bundle; Naming conventions From 7b8f0fbd1d052cfc1785e2802df66c8fb17b281d Mon Sep 17 00:00:00 2001 From: Ryan Weaver Date: Mon, 6 Oct 2014 10:06:18 -0400 Subject: [PATCH 2/2] Some fixes thanks to @stof --- cookbook/bundles/best_practices.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/cookbook/bundles/best_practices.rst b/cookbook/bundles/best_practices.rst index 383bb3a8b01..c8a0923e842 100644 --- a/cookbook/bundles/best_practices.rst +++ b/cookbook/bundles/best_practices.rst @@ -6,8 +6,8 @@ Best Practices for Reusable Bundles There are 2 types of bundles: -* Application bundles: only use to build your application; -* Reusable bundle: meant to be shared across many projects. +* Application-specific bundles: only used to build your application; +* Reusable bundles: meant to be shared across many projects. This article is all about how to structure your **reusable bundles** so that they're easy to configure and extend. Many of these recommendations do not