sonata admin integration

symfony-cmf / symfony-cmf-docs

The documentation for the symfony content management framework

http://cmf.symfony.com

44 stars 157 forks source link

sonata admin integration #790

Closed dbu closed 7 years ago

dbu commented 7 years ago

fix #785

i want to merge this asap so that we can move the individual bundle admin docs and clean up stuff. i wonder how much we want to explain about setting up sonata in general. should we leave that in the tutorial or move here?

ElectricMaxxx commented 7 years ago

I would keep it simple and not explain sonata again, means:

mention all possible admins and its documents and their bundle (where they are from)* explain how to enable a complete bundle by its configuration
explain how to enable ONE single admin with its class and its paths and form_groups
explain all extensions, how to enalble them, and their purpose separated by bundles (where they are from)

dbu commented 7 years ago

i wonder how much of https://github.com/symfony-cmf/symfony-cmf-docs/blob/master/tutorial/sonata-admin.rst we should move here or if we leave that in the tutorial?

ElectricMaxxx commented 7 years ago

sonata has enough own documentation, the phpcr-backend part too. With that bundle we also alligned a lot, so one single admin example can be enough from my POV.

Our main purpose is not to explain how sonata is working. We should focus on the stuff, where we present the features of the CMF mean:

here you can have a simple example how public workflow looks like
here you can see|edit the tree structure of the PHPCR

dbu commented 7 years ago

Will you also do #786 here?

depends on what we mean by "all sonata docs". i think we should move bundle docs per bundle, as we clean up the bundle documentation in general. that will be more manageable than one huge move.

wouterj commented 7 years ago

I would say:

Explain how to install this bundle
Link to Sonata docs for installation guides on their side
Show how to enable/disable admins and persistence layer (will submit a PR this night)
Show the available admins and their extensions, admin factory per admin factory.
Maybe other information that we find when extracting admin stuff from the bundles

wouterj commented 7 years ago

@dbu are you working on this PR or can I take it over and continue writing?

dbu commented 7 years ago

i hope to find some time this friday or saturday to move this forward. until then, if you can continue with the foundations, please do. maybe we can also add some todo's here and then merge this to work in smaller junks.

wouterj commented 7 years ago

Bootstrapped the documentation the way I think we should document this. I think we can merge it as is and fill in the other bundle integrations per bundle in seperate PRs.

As always, open for every comment you can think of 😃.

dbu commented 7 years ago

i fixed the errors. would love to decide on splitting configuration (and other doc) into a page per bundle and do that in here, then we can merge this and fill in things in parallel

dbu commented 7 years ago

squash and merge?