Skip to content
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.

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

Bundle breadcrumb may be confusing #20800

Open
MrYamous opened this issue Mar 22, 2025 · 1 comment
Open

Bundle breadcrumb may be confusing #20800

MrYamous opened this issue Mar 22, 2025 · 1 comment

Comments

@MrYamous
Copy link
Contributor

Historically, Symfony projects were organized as bundles.
Today this is no longer the case but the term is still used to designate some packages made for Symfony.

In some places in the documentation, in the breadcrumb for example, I find that the two are mixed up and I think this can be confusing.

Lets take an exemple, Best Practices For Reusable Bundles which refers to bundles as packages but I if click on "Bundles" I'm redirected to a page that deals with the old system and says that it should no longer be used.

I also noticed main bundle documentation, which refers to old system, is accessible from index in the Architecture section but it seems outdated.

I can understand removing pages from the documentation might be a problem, but couldn't we find a solution to make this old bundle system less visible, remove it from the index, and improve the breadcrumb of pages that deal with bundles as packages?
Like by introducing a new page about main differences between PHP packages and Symfony Bundles, and using this new page in breadcrumb as top level of relevant pages.

@javiereguiluz
Copy link
Member

I don't fully understand this. The caution message in the bundles page says that "using bundles in your own app is no longer recommended" ... but bundles are not deprecated at all. They are still recommended e.g. when creating reusable code for multiple projects (i.e. third-party bundles).

I think we should update that page to merge everything about creating bundles for Symfony apps in a single page. And, modernize the contents a bit (and add important missing contents like creating functional tests in bundles with a micro kernel app).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants