Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit ef11ef4

Browse files
committed
minor #4250 Clarifying Bundle Best Practices is for *reusable* bundles (weaverryan)
This PR was submitted for the master branch but it was merged into the 2.3 branch instead (closes #4250). Discussion ---------- Clarifying Bundle Best Practices is for *reusable* bundles | Q | A | ------------- | --- | Doc fix? | no | New docs? | No | Applies to | 2.3+ | Fixed tickets | Hi guys! I wanted to be a little bit more clear that the bundle best practices doc is all about structuring your reusable bundles, not necessarily your application bundles. I realize I broke from the Cookbook-standard of "How to..." title, but this title sounded the best to me. I'm also not worried about breaking the anchor on the top title, since it's already the top of the page. Thanks! Commits ------- 1caa1fd Some fixes thanks to @stof e7b1ae3 Clarifying that the bundles best practices entry is for reusable bundles, not for app bundles
2 parents 430eabf + 1caa1fd commit ef11ef4

File tree

1 file changed

+12
-5
lines changed

1 file changed

+12
-5
lines changed

cookbook/bundles/best_practices.rst

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,19 @@
11
.. index::
22
single: Bundle; Best practices
33

4-
How to Use best Practices for Structuring Bundles
5-
=================================================
4+
Best Practices for Reusable Bundles
5+
===================================
66

7-
A bundle is a directory that has a well-defined structure and can host anything
8-
from classes to controllers and web resources. Even if bundles are very
9-
flexible, you should follow some best practices if you want to distribute them.
7+
There are 2 types of bundles:
8+
9+
* Application-specific bundles: only used to build your application;
10+
* Reusable bundles: meant to be shared across many projects.
11+
12+
This article is all about how to structure your **reusable bundles** so that
13+
they're easy to configure and extend. Many of these recommendations do not
14+
apply to application bundles because you'll want to keep those as simple
15+
as possible. For application bundles, just follow the practices shown throughout
16+
the book and cookbook.
1017

1118
.. index::
1219
pair: Bundle; Naming conventions

0 commit comments

Comments
 (0)