sonata admin integration #790

dbu · 2016-12-19T16:49:06Z

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 · 2016-12-20T07:34:09Z

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 · 2016-12-20T07:39:14Z

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 · 2016-12-20T07:43:42Z

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

dantleech · 2016-12-20T12:46:22Z

bundles/map.rst.inc

+Sonata Admin Integration
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since version 2 of the CMF, we provide a separate bundle with admin interfaces for the


admin interfaces => admin integrations/services ?

maybe implementations

dantleech · 2016-12-20T12:47:11Z

bundles/sonata_admin_integration/introduction.rst

+
+    The SonataAdminIntegrationBundle provides admin services for the Sonata
+    Admin tool. Additionally, it provides admin extensions to improve your
+    custom admins.


admins => admin services ?

ElectricMaxxx

Will you also do #786 here?

ElectricMaxxx · 2016-12-20T16:17:10Z

bundles/map.rst.inc

+Sonata Admin Integration
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Since version 2 of the CMF, we provide a separate bundle with admin interfaces for the


maybe implementations

ElectricMaxxx · 2016-12-20T16:18:09Z

bundles/sonata_admin_integration/introduction.rst

+Installation
+------------
+
+should we move tutorial sonata-admin.rst here and get rid of the tutorial?


dbu · 2016-12-20T16:33:32Z

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 · 2016-12-22T23:04:22Z

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 · 2017-01-03T12:37:22Z

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

dbu · 2017-01-03T12:51:17Z

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 · 2017-01-04T11:05:54Z

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 · 2017-01-13T11:24:01Z

bundles/sonata_phpcr_admin_integration/introduction.rst

+-------------
+
+This section documents all available admin integrations in this bundle, with
+their configuration options.


should we split the documentation for each bundle integration into its own page? i think otherwise the doc gets very long and unweildy otherwise. i'd rather group configuration and other usage instruction for a specific bundle into one page, than configuration => each bundle, tips => each bundle.

dbu · 2017-01-13T11:24:56Z

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

wouterj · 2017-01-14T10:46:09Z

bundles/sonata_phpcr_admin_integration/introduction.rst

+        return $bundles;
+    }
+
+Sonata requires the ``sonata_block`` bundle to be configured in your main


this is precisly the stuff I would not want to see in here: This is about installing the sonata admin bundle, not our integration bundle.

removed (and did not place back into the tutorial) and replaced with a link to the sonata doc

wouterj · 2017-01-14T10:46:48Z

bundles/sonata_phpcr_admin_integration/introduction.rst

+
+        return $collection;
+
+and publish your assets (remove ``--symlink`` if you use Windows!):


removing --symlink is not needed:

If you run as admin in windows, symlinks are supported

If it isn't supported, the option will simply be ignored by Symfony

wouterj · 2017-01-14T10:47:15Z

bundles/sonata_phpcr_admin_integration/introduction.rst

+-------------
+
+This section documents all available admin integrations in this bundle, with
+their configuration options.


dbu · 2017-01-16T12:08:36Z

squash and merge?

started on documenting the sonata admin integration bundle

ea7c69a

lsmith77 added the wip/poc label Dec 19, 2016

ElectricMaxxx added this to the 2.0 milestone Dec 20, 2016

dantleech reviewed Dec 20, 2016

View reviewed changes

ElectricMaxxx reviewed Dec 20, 2016

View reviewed changes

wouterj force-pushed the admin-integration branch from 411ce29 to 27b6ff3 Compare January 4, 2017 11:08

Bootstrapped the sonata phpcr admin integration docs

e58dfb1

wouterj force-pushed the admin-integration branch from 27b6ff3 to e58dfb1 Compare January 4, 2017 16:32

dbu added 3 commits January 13, 2017 10:49

continued sonata admin

1bafca3

add missing link target

8301ca6

fix link

cb5264f

dbu commented Jan 13, 2017

View reviewed changes

wouterj reviewed Jan 14, 2017

View reviewed changes

dbu changed the title ~~WIP: sonata admin integration~~ sonata admin integration Jan 16, 2017

remove sonata setup instructions, split admin integration doc

4784fea

dbu force-pushed the admin-integration branch from e50d750 to 4784fea Compare January 16, 2017 12:45

dbu merged commit d82a76d into 2.0 Jan 17, 2017

dbu removed the wip/poc label Jan 17, 2017

dbu deleted the admin-integration branch January 17, 2017 08:42

dbu mentioned this pull request Jan 17, 2017

Document the SonataAdminIntegrationBundle #785

Closed


		return $collection;

		and publish your assets (remove ``--symlink`` if you use Windows!):

sonata admin integration #790

sonata admin integration #790

Uh oh!

Conversation

dbu commented Dec 19, 2016

Uh oh!

ElectricMaxxx commented Dec 20, 2016

Uh oh!

dbu commented Dec 20, 2016

Uh oh!

ElectricMaxxx commented Dec 20, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

dantleech Dec 20, 2016 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ElectricMaxxx left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dbu commented Dec 20, 2016 via email

Uh oh!

wouterj commented Dec 22, 2016

Uh oh!

wouterj commented Jan 3, 2017

Uh oh!

dbu commented Jan 3, 2017

Uh oh!

wouterj commented Jan 4, 2017

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dbu commented Jan 13, 2017

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

dbu commented Jan 16, 2017

Uh oh!

Uh oh!

ElectricMaxxx commented Dec 20, 2016 •

edited

Loading

dantleech Dec 20, 2016 •

edited

Loading