Skip to content

Commit

Permalink
minor #4250 Clarifying Bundle Best Practices is for *reusable* bundle…
Browse files Browse the repository at this point in the history
…s (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
  • Loading branch information
weaverryan committed Oct 6, 2014
2 parents 430eabf + 1caa1fd commit ef11ef4
Showing 1 changed file with 12 additions and 5 deletions.
17 changes: 12 additions & 5 deletions cookbook/bundles/best_practices.rst
Original file line number Diff line number Diff line change
@@ -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-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
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
Expand Down

0 comments on commit ef11ef4

Please sign in to comment.