Want to help

[Mark Sellers]

My name is Mark Sellers and I operate a number of websites, currently based on Drupal 7. During my career, I was a software engineer, mostly working on embedded systems (assembly language and C mostly). I am wanting to transition my websites to a more developer oriented framework, so I have selected Symfony.

My websites combine content management requirements, and web application components, so I need to combine CMF along with more traditional and transactional RDBMS oriented operation.

I have been working with the Symfony-CMF, and hope to join this group to help out with some issues that (from my perspective) are very important.

Number 1 issue is that the current website documentation needs some improvement. Even the most basic tutorial example requires "insider" knowledge to perform successfully. As written, the naive user would not have success in accomplishing the demo without having to google. If anything must work, the most basic tutorial should work without having to google outside resources to find answers that should be included in the tutorial.

OK - sorry for the long into and on to a simple question, and how can we have the answer documented so that users have a better experience starting with Symfony-CMF.

1) Upon what Symfony-SE version should is required for the CMF?
2) How can I update the website docs on the page http://symfony.com/doc/master/cmf/cookbook/database/create_new_project_phpcr_odm.html to make sure that the proper version is installed that will support the successful completion of the tutorial?

Thanks!
Mark

PS - you will see me on the IRC channel as msellers.

[Daniel Leech]

Hi Mark,

Of course your help would be greatly appreciated :)

To update the docs you need to submit a pull request on the
symfony-cmf-docs repo:

https://github.com/symfony-cmf/symfony-cmf-docs

The documentation is probably instructing the user to pull in the
lastest SE -- but that has surely changed, and is perhaps the reason
that the tutorial didn't work for you.

Maybe we should explicitly tell the user which version to use in the
documentation to avoid such problems in the future. If you submit a pull
request then we can discuss further on Github.

Cheers,

Dan

> --
> You received this message because you are subscribed to the Google Groups
> "symfony-cmf-devs" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [1]symfony-cmf-de...@googlegroups.com.
> For more options, visit [2]https://groups.google.com/d/optout.
>
> References
>
> Visible links
> 1. mailto:symfony-cmf-de...@googlegroups.com
> 2. https://groups.google.com/d/optout

[Mark Sellers]

You are correct. The docs do not mention what version of the SE
should be installed (defaults to 3.0). I found that 2.8 has a problem
also. I am testing 2.7 latest from top to bottom, and then will do
as you recommend, submit a pull request and update the docs
to point to a revision that works with the current cmf repo.

Mark