Skip to content

Clarifying Bundle Best Practices is for *reusable* bundles #4250

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 2 commits into from
Closed

Clarifying Bundle Best Practices is for *reusable* bundles #4250

Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e65f443
Clarifying that the bundles best practices entry is for reusable bund…
weaverryan Sep 18, 2014
7b8f0fb
Some fixes thanks to @stof
weaverryan Oct 6, 2014
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 12 additions & 5 deletions cookbook/bundles/best_practices.rst
View file
Open in desktop
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 bundles: only use to build your application;
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo: used

* Reusable bundle: meant to be shared across many projects.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

bundles, to be consistent


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