at the hackday in zurich we decided we want to have a documentation version per major release (so 1.0 and master from this summer, 1.0 and 1.1 and master once 1.1 is released...). how can we implement this on symfony.com? can we at all?

the release cycle is not strictly linked to symfony core, and the versions certainly are not (cmf 1.1 will most likely still support symfony 2.3).

/cc @fabpot

Describing front end editing (with create.js).

Describes the use of the menu with CMF.

Link to doctrine documentation:
http://docs.doctrine-project.org/projects/doctrine-phpcr-odm/en/latest/

Includes (but not limited to) dependencies, independent installation, usage, examples, full configuration options. Targets developers with some or a lot of experience with CMF and developers who want to use the bundle independently.

High level Why? Use information of the “Why Symfony2 CMF?” sheets.

Includes (but not limited to) dependencies, independent installation, usage, examples, full configuration options. Targets developers with some or a lot of experience with CMF and developers who want to use the bundle independently.

Link to http://sonata-project.org/bundles/admin/master/doc/index.html

If relevant describe differences and/or CMF specific examples

Describes the steps necessary to build a CMS with CMF and Sonata.

I'm following the docs from http://symfony-cmf.readthedocs.org/en/latest/tutorials/installing-configuring-cmf.html

There it states to use

"post-install-cmd": [
    "Liip\\VieBundle\\Composer\\ScriptHandler::initSubmodules",
    ...
],
"post-update-cmd": [
    "Liip\\VieBundle\\Composer\\ScriptHandler::initSubmodules",
    ...
]

But after reading the composer.json from https://github.com/symfony-cmf/symfony-cmf and installing the cmf with composer, no Liip bundle appear in my vendor folder, thus not executing those commands.
Is it possible that those commands shouldn't be there? or the composer.json from symfony-cmf to be wrong?
There is no other reference to the LiipBundle in those docs.

Regards,
Eduardo.

The breadcrumb doesn't render nice in the CMF docs. For instance, navigating to cmf/bundles/block/introduction, I expect to see:

Home » Documentation » Symfony CMF Documentation » Bundles » BlockBundle » The BlockBundle 

But the actual result is:

Home » Documentation » Symfony CMF Documentation » BlockBundle » The BlockBundle 

Visiting URLs which are only one level deep, for instance getting_started/menu will render only:

Home » Documentation » Symfony CMF Documentation » Menu

I expected:

Home » Documentation » Symfony CMF Documentation » Getting Started » Menu

On the core docs, it all works fine.

/cc @fabpot

Explaining: between your website and symfony's, there are at least 3 installation guides: The one in the cmf.symfony.com home, for the "clean" version, the one in "get started" for the sandbox version, and the complete version for installation on top of an existing symfony 2 installation.

IMO all the info should be compiled in the sf page. The installation guide should be for the clean version, a "start here and follow the next pages" thing, like it's done in the main sf docs.
This page would also contain links to the other two installation instruction sets. Those two versions I suggest storing them as cookbook entries, as one is for demo purposes and the other is for expert users who want to tweak details or get to know the tool's insides.

I'd like your feedback on this before actually starting doing something.

Also, is there some kind of nice editor for .rst files for ubuntu/linux? Gedit is ok, but it would be nice to have something a bit less hardcore, specially for a first timer ;)

Sync with

• cookbook/installing_configuring_doctrine_phpcr_odm.rst
• cookbook/installing_configuring_inline_editing.rst
• cookbook/editions/*

Includes (but not limited to) dependencies, independent installation, usage, examples, full configuration options. Targets developers with some or a lot of experience with CMF and developers who want to use the bundle independently.

In openpsa/createphp#46, the templating changed. Now, http://symfony.com/doc/master/cmf/bundles/create.html#usage needs to be updated.

Renamed from TermsFormType to CheckboxUrlLabelFormType and moved to CoreBundle

symfony-cmf/create-bundle#59 is done

for example: http://symfony.com/doc/current/cmf/bundles/simple_cms.html

also check the block "introduction" section to re-add xml and php configuration

The ContentBundle is missing documentation. Recommend sections:

• Introduction
• Installation
  • Dependencies
• Usage

After running

app/console doctrine:phpcr:init:dbal

with works fine, and then:

app/console doctrine:phpcr:repository:init

I get error:

  [InvalidArgumentException]                                                   
  There are no commands defined in the "doctrine:phpcr:repository" namespace. 

Any help would welcome.

Just a simple placeholder to remind me of this after 14 days...

• Finish the rewrite started in #186 (3 todo comments + the other sections)
• Split the article in multiple articles (long articles are demotivating): ChainRouter, DynamicRouter, NestedMatcher
• Document all features included in the component (don't have any "look at the source code" in the article)
• Document new features
  • Compiler Passes
• Update RoutingBundle docs to not have duplicated things

Describes the multilingual features of CMF.

@kossi added support for ckeditor to the CreateBundle. you promised to document it on april 20th ;-)
symfony-cmf/create-bundle#46

Includes (but not limited to) dependencies, independent installation, usage, examples, full configuration options. Targets developers with some or a lot of experience with CMF and developers who want to use the bundle independently.

do we need a license file here too? and should it be MIT or some creative commons - as this is not code but documentation?

Installation and (less as possible) configuration to get a CMF project running. Further configuration should be handled in the book or reference. Installation guide assumes an combined implementation (of the different CMF bundles).

Should also include subsections for:

• Installing and configuring with Doctrine PHPCR ODM
• Installing and configuring with Doctrine DBAL

similar to https://github.com/symfony-cmf/CoreBundle/blob/master/CONTRIBUTING.md but pointing to the doc PR template.

/cc @wouterj do you want to propose a PR?

As you properbly already know, I love consistency. My main task at the symfony docs is reviewing all incoming PRs and making them ready for merging.
To ease my job, I had put some standards together to make my review task a bit easier.

Some days ago, I got interested by the CMF project. It's a great project as far as I understand it, but one thing made my sad: The documentation. The text is great, but the format is really inconsistent and sometimes incorrect.

With a little bit more effort, I can do some minor reviewing at the PRs here as well, but that means I need to have some standard. From your contributing page, I concluded that you use the Symfony standards.

But looking at the docs, it looks like you don't follow those. For instance, you're breaking around the 100th character, well the docs do that at the 72th character.

With this issue, I want to know if you like it if I'm going to do some review job here and I want to know which standard you use (or better said, which standards you follow and which not).

Includes (but not limited to) dependencies, independent installation, usage, examples, full configuration options. Targets developers with some or a lot of experience with CMF and developers who want to use the bundle independently.

The SearchBundle is missing documentation. Recommend sections:

• Introduction
• Installation
  • Dependencies
• Usage

High level Why? Use information of the “Why Symfony2 CMF?” sheets.

we could cover in one, or even both the twig integration:
http://symfony.com/doc/master/cmf/bundles/routing.html
http://symfony.com/doc/master/cmf/getting-started/routing.html

ie. being able to pass route/content path/instances along with parameters and how locale requirements are handled etc.

https://github.com/fabpot/sphinx-php

Link to https://github.com/doctrine/DoctrinePHPCRBundle/blob/master/README.md

Includes (but not limited to) dependencies, independent installation, usage, examples, full configuration options. Targets developers with some or a lot of experience with CMF and developers who want to use the bundle independently.

adjust this tutorial (and possibly others) to use composer. the submodules are gone.
https://github.com/symfony-cmf/symfony-cmf-docs/blob/master/tutorials/installing-configuring-doctrine-phpcr-odm.rst

Documentation overview, directing user to their information.

Describes the use of blocks with CMF.

update the routing component doc (and routing extra bundle where needed) for the refactoring of NestedMatcher and RouteEnhancers

Describes the use of routing with CMF.

See #179 (comment)

Describes the use of content with CMF.

Includes (but not limited to) dependencies, independent installation, usage, examples, full configuration options. Targets developers with some or a lot of experience with CMF and developers who want to use the bundle independently.

Includes (but not limited to) dependencies, independent installation, usage, examples, full configuration options. Targets developers with some or a lot of experience with CMF and developers who want to use the bundle independently.

The items are not clickable.

URL: http://symfony.com/doc/master/cmf/tutorials/index.html